diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 0bc3b42d..d401a774 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -5,7 +5,7 @@ updates:
   schedule:
     interval: daily
     time: "10:00"
-  open-pull-requests-limit: 10
+  open-pull-requests-limit: 20
   commit-message:
     prefix: "deps"
     prefix-development: "deps(dev)"
diff --git a/.github/workflows/js-test-and-release.yml b/.github/workflows/js-test-and-release.yml
index 35d87d10..1d7ff79c 100644
--- a/.github/workflows/js-test-and-release.yml
+++ b/.github/workflows/js-test-and-release.yml
@@ -9,7 +9,9 @@ on:
 
 permissions:
   contents: write
+  id-token: write
   packages: write
+  pull-requests: write
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.event_name == 'push' && github.sha || github.ref }}
diff --git a/.github/workflows/semantic-pull-request.yml b/.github/workflows/semantic-pull-request.yml
new file mode 100644
index 00000000..bd00f090
--- /dev/null
+++ b/.github/workflows/semantic-pull-request.yml
@@ -0,0 +1,12 @@
+name: Semantic PR
+
+on:
+  pull_request_target:
+    types:
+      - opened
+      - edited
+      - synchronize
+
+jobs:
+  main:
+    uses: pl-strflt/.github/.github/workflows/reusable-semantic-pull-request.yml@v0.3
diff --git a/README.md b/README.md
index b24df40e..681daf4d 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
   </a>
 </p>
 
-# @helia/mfs <!-- omit in toc -->
+# @helia/mfs
 
 [![ipfs.tech](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](https://ipfs.tech)
 [![Discuss](https://img.shields.io/discourse/https/discuss.ipfs.tech/posts.svg?style=flat-square)](https://discuss.ipfs.tech)
@@ -13,30 +13,23 @@
 
 > A mutable filesystem powered by Helia
 
-## Table of contents <!-- omit in toc -->
-
-- [Structure](#structure)
-- [API Docs](#api-docs)
-- [License](#license)
-- [Contribute](#contribute)
-
-## Structure
+# Packages
 
 - [`/packages/interop`](./packages/interop) Interop tests for @helia/mfs
 - [`/packages/mfs`](./packages/mfs) A mutable filesystem powered by Helia
 
-## API Docs
+# API Docs
 
 - <https://ipfs.github.io/helia-mfs>
 
-## License
+# License
 
 Licensed under either of
 
 - Apache 2.0, ([LICENSE-APACHE](LICENSE-APACHE) / <http://www.apache.org/licenses/LICENSE-2.0>)
 - MIT ([LICENSE-MIT](LICENSE-MIT) / <http://opensource.org/licenses/MIT>)
 
-## Contribute
+# Contribute
 
 Contributions welcome! Please check out [the issues](https://github.com/ipfs/helia-mfs/issues).
 
diff --git a/package.json b/package.json
index ee3e238f..4369065e 100644
--- a/package.json
+++ b/package.json
@@ -11,6 +11,10 @@
   "bugs": {
     "url": "https://github.com/ipfs/helia-mfs/issues"
   },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "keywords": [
     "ipfs"
   ],
@@ -36,7 +40,7 @@
     "docs:no-publish": "NODE_OPTIONS=--max_old_space_size=8192 aegir docs --publish false -- --exclude packages/interop"
   },
   "devDependencies": {
-    "aegir": "^41.0.0",
+    "aegir": "^42.0.1",
     "npm-run-all": "^4.1.5"
   },
   "type": "module",
diff --git a/packages/interop/README.md b/packages/interop/README.md
index 644f58c5..b81c629a 100644
--- a/packages/interop/README.md
+++ b/packages/interop/README.md
@@ -4,7 +4,7 @@
   </a>
 </p>
 
-# @helia/mfs-interop <!-- omit in toc -->
+# @helia/mfs-interop
 
 [![ipfs.tech](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](https://ipfs.tech)
 [![Discuss](https://img.shields.io/discourse/https/discuss.ipfs.tech/posts.svg?style=flat-square)](https://discuss.ipfs.tech)
@@ -13,19 +13,14 @@
 
 > Interop tests for @helia/mfs
 
-## Table of contents <!-- omit in toc -->
-
-- [License](#license)
-- [Contribute](#contribute)
-
-## License
+# License
 
 Licensed under either of
 
 - Apache 2.0, ([LICENSE-APACHE](LICENSE-APACHE) / <http://www.apache.org/licenses/LICENSE-2.0>)
 - MIT ([LICENSE-MIT](LICENSE-MIT) / <http://opensource.org/licenses/MIT>)
 
-## Contribute
+# Contribute
 
 Contributions welcome! Please check out [the issues](https://github.com/ipfs/helia-mfs/issues).
 
diff --git a/packages/interop/package.json b/packages/interop/package.json
index e7047557..73aceb0b 100644
--- a/packages/interop/package.json
+++ b/packages/interop/package.json
@@ -3,7 +3,7 @@
   "version": "0.0.0",
   "description": "Interop tests for @helia/mfs",
   "license": "Apache-2.0 OR MIT",
-  "homepage": "https://github.com/ipfs/helia-mfs/tree/master/packages/interop#readme",
+  "homepage": "https://github.com/ipfs/helia-mfs/tree/main/packages/interop#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ipfs/helia-mfs.git"
@@ -11,6 +11,10 @@
   "bugs": {
     "url": "https://github.com/ipfs/helia-mfs/issues"
   },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "keywords": [
     "IPFS"
   ],
@@ -49,11 +53,11 @@
     "test:electron-main": "aegir test -t electron-main"
   },
   "devDependencies": {
-    "@helia/interface": "^2.0.0",
+    "@helia/interface": "^3.0.0",
     "@helia/mfs": "^1.0.0",
-    "aegir": "^41.0.3",
+    "aegir": "^42.0.1",
     "go-ipfs": "^0.22.0",
-    "helia": "^2.0.3",
+    "helia": "^3.0.0",
     "ipfsd-ctl": "^13.0.0",
     "kubo-rpc-client": "^3.0.0",
     "merge-options": "^3.0.4",
diff --git a/packages/interop/typedoc.json b/packages/interop/typedoc.json
deleted file mode 100644
index f599dc72..00000000
--- a/packages/interop/typedoc.json
+++ /dev/null
@@ -1,5 +0,0 @@
-{
-  "entryPoints": [
-    "./src/index.ts"
-  ]
-}
diff --git a/packages/mfs/README.md b/packages/mfs/README.md
index f5c0318f..59a7d4e4 100644
--- a/packages/mfs/README.md
+++ b/packages/mfs/README.md
@@ -4,7 +4,7 @@
   </a>
 </p>
 
-# @helia/mfs <!-- omit in toc -->
+# @helia/mfs
 
 [![ipfs.tech](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](https://ipfs.tech)
 [![Discuss](https://img.shields.io/discourse/https/discuss.ipfs.tech/posts.svg?style=flat-square)](https://discuss.ipfs.tech)
@@ -13,21 +13,42 @@
 
 > A mutable filesystem powered by Helia
 
-## Table of contents <!-- omit in toc -->
+# About
 
-- [Install](#install)
-  - [Browser `<script>` tag](#browser-script-tag)
-- [API Docs](#api-docs)
-- [License](#license)
-- [Contribute](#contribute)
+`@helia/mfs` is an implementation of a Mutable File System powered by Helia.
 
-## Install
+See the interface for all available operations.
+
+## Example
+
+```typescript
+import { createHelia } from 'helia'
+import { mfs } from '@helia/mfs'
+
+const helia = createHelia({
+  // ... helia config
+})
+const fs = mfs(helia)
+
+// create an empty directory
+await fs.mkdir('/my-directory')
+
+// add a file to the directory
+await fs.writeBytes(Uint8Array.from([0, 1, 2, 3]), '/my-directory/foo.txt')
+
+// read the file
+for await (const buf of fs.cat('/my-directory/foo.txt')) {
+  console.info(buf)
+}
+```
+
+# Install
 
 ```console
 $ npm i @helia/mfs
 ```
 
-### Browser `<script>` tag
+## Browser `<script>` tag
 
 Loading this module through a script tag will make it's exports available as `HeliaMfs` in the global namespace.
 
@@ -35,18 +56,18 @@ Loading this module through a script tag will make it's exports available as `He
 <script src="https://unpkg.com/@helia/mfs/dist/index.min.js"></script>
 ```
 
-## API Docs
+# API Docs
 
-- <https://ipfs.github.io/helia-mfs/modules.html>
+- <https://ipfs.github.io/helia-mfs/modules/_helia_mfs.html>
 
-## License
+# License
 
 Licensed under either of
 
 - Apache 2.0, ([LICENSE-APACHE](LICENSE-APACHE) / <http://www.apache.org/licenses/LICENSE-2.0>)
 - MIT ([LICENSE-MIT](LICENSE-MIT) / <http://opensource.org/licenses/MIT>)
 
-## Contribute
+# Contribute
 
 Contributions welcome! Please check out [the issues](https://github.com/ipfs/helia-mfs/issues).
 
diff --git a/packages/mfs/package.json b/packages/mfs/package.json
index 00bf6715..d5c2757e 100644
--- a/packages/mfs/package.json
+++ b/packages/mfs/package.json
@@ -3,7 +3,7 @@
   "version": "1.0.2",
   "description": "A mutable filesystem powered by Helia",
   "license": "Apache-2.0 OR MIT",
-  "homepage": "https://github.com/ipfs/helia-mfs/tree/master/packages/mfs#readme",
+  "homepage": "https://github.com/ipfs/helia-mfs/tree/main/packages/mfs#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ipfs/helia-mfs.git"
@@ -11,6 +11,10 @@
   "bugs": {
     "url": "https://github.com/ipfs/helia-mfs/issues"
   },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "keywords": [
     "IPFS"
   ],
@@ -135,28 +139,28 @@
     "release": "aegir release"
   },
   "dependencies": {
-    "@helia/interface": "^2.0.0",
-    "@helia/unixfs": "^1.2.2",
-    "@ipld/dag-pb": "^4.0.0",
+    "@helia/interface": "^3.0.0",
+    "@helia/unixfs": "^2.0.0",
     "@libp2p/interfaces": "^3.3.1",
-    "@libp2p/logger": "^3.0.1",
-    "interface-blockstore": "^5.0.0",
+    "@libp2p/logger": "^4.0.4",
     "interface-datastore": "^8.2.2",
     "ipfs-unixfs": "^11.0.0",
     "ipfs-unixfs-exporter": "^13.1.0",
     "ipfs-unixfs-importer": "^15.1.0",
-    "it-last": "^3.0.1",
-    "multiformats": "^12.0.1"
+    "multiformats": "^13.0.0"
   },
   "devDependencies": {
-    "aegir": "^41.0.3",
+    "@ipld/dag-pb": "^4.0.7",
+    "aegir": "^42.0.1",
     "blockstore-core": "^4.0.1",
     "datastore-core": "^9.2.0",
     "delay": "^6.0.0",
+    "interface-blockstore": "^5.2.9",
     "it-all": "^3.0.1",
     "it-drain": "^3.0.1",
     "it-first": "^3.0.1",
+    "it-last": "^3.0.4",
     "it-to-buffer": "^4.0.1",
-    "uint8arrays": "^4.0.3"
+    "uint8arrays": "^5.0.1"
   }
 }