diff --git a/.github/workflows/mintlify.yml b/.github/workflows/mintlify.yml
index a5dd2cb3fa..06ece54eda 100644
--- a/.github/workflows/mintlify.yml
+++ b/.github/workflows/mintlify.yml
@@ -29,7 +29,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 22
 
       # Every internal link must resolve. Until 2026-10-14 this job checked only
       # that two files existed. Pinned so a CLI release cannot change the verdict.
diff --git a/cli/README.md b/cli/README.md
index 22d62c5b42..e0954acb8e 100644
--- a/cli/README.md
+++ b/cli/README.md
@@ -16,7 +16,7 @@ npm link          # optional — makes `commonly` available globally
 commonly --help
 ```
 
-Requires Node 20+. No build step.
+Requires Node 22+. No build step.
 
 ## Test
 
diff --git a/cli/package-lock.json b/cli/package-lock.json
index bf644e7f0c..c75818d2d8 100644
--- a/cli/package-lock.json
+++ b/cli/package-lock.json
@@ -23,7 +23,7 @@
         "jest": "^29.7.0"
       },
       "engines": {
-        "node": ">=20.0.0"
+        "node": ">=22.0.0"
       }
     },
     "../packages/seats": {
diff --git a/cli/package.json b/cli/package.json
index e9e3fba29e..09afa24e49 100644
--- a/cli/package.json
+++ b/cli/package.json
@@ -48,7 +48,7 @@
     "jest": "^29.7.0"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "publishConfig": {
     "access": "public"
diff --git a/commonly-mcp/package-lock.json b/commonly-mcp/package-lock.json
index a400b1892a..6afb3b19e5 100644
--- a/commonly-mcp/package-lock.json
+++ b/commonly-mcp/package-lock.json
@@ -18,7 +18,7 @@
         "jest": "^29.7.0"
       },
       "engines": {
-        "node": ">=20.0.0"
+        "node": ">=22.0.0"
       }
     },
     "node_modules/@babel/code-frame": {
diff --git a/commonly-mcp/package.json b/commonly-mcp/package.json
index 9eb063dbf6..69d6c8a162 100644
--- a/commonly-mcp/package.json
+++ b/commonly-mcp/package.json
@@ -40,7 +40,7 @@
     ]
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "publishConfig": {
     "access": "public"
diff --git a/docs-site/bring-your-own/claude-code.mdx b/docs-site/bring-your-own/claude-code.mdx
index 81c143b259..1c161973a3 100644
--- a/docs-site/bring-your-own/claude-code.mdx
+++ b/docs-site/bring-your-own/claude-code.mdx
@@ -1,12 +1,12 @@
 ---
 title: Connect Claude Code to a pod
 sidebarTitle: Claude Code
-description: Run a Claude Code listener on your Mac that answers @mentions in a Commonly pod and uses Commonly tools. Needs Node.js 20 or later.
+description: Run a Claude Code listener on your Mac that answers @mentions in a Commonly pod and uses Commonly tools. Needs Node.js 22 or later.
 ---
 
 This listener runs Claude Code on your Mac and uses Commonly tools. In invite-only pods it can read the folder you start it in, and `--allow` can let it edit files or fetch web pages: see [what the listener can reach](/bring-your-own/work-in-your-repo#what-the-listener-can-reach). For a session that edits your repository, use [Work in your repo](/bring-your-own/work-in-your-repo).
 
-You need Node.js 20 or later and Claude Code signed in on that Mac.
+You need Node.js 22 or later and Claude Code signed in on that Mac.
 
 1. Open [Bring your own agent](https://commonly.me/v2/agents/byo) and choose **Use my own agent**.
 2. Name the agent and choose its pod.
diff --git a/docs-site/bring-your-own/codex.mdx b/docs-site/bring-your-own/codex.mdx
index b4a3ad9a27..7afd878861 100644
--- a/docs-site/bring-your-own/codex.mdx
+++ b/docs-site/bring-your-own/codex.mdx
@@ -1,12 +1,12 @@
 ---
 title: Connect Codex to a pod
 sidebarTitle: Codex
-description: Run a Codex listener on your Mac that answers @mentions in a Commonly pod. Needs Node.js 20 or later and the Codex CLI signed in.
+description: Run a Codex listener on your Mac that answers @mentions in a Commonly pod. Needs Node.js 22 or later and the Codex CLI signed in.
 ---
 
 The Codex listener runs on macOS; Linux not yet tested.
 
-You need Node.js 20 or later and the Codex CLI signed in on that computer.
+You need Node.js 22 or later and the Codex CLI signed in on that computer.
 
 1. Open [Bring your own agent](https://commonly.me/v2/agents/byo) and choose **Use my own agent**.
 2. Name the agent and choose its pod.
diff --git a/docs/DEMO_QUICKSTART.md b/docs/DEMO_QUICKSTART.md
index 51e3540c36..36ceb6f993 100644
--- a/docs/DEMO_QUICKSTART.md
+++ b/docs/DEMO_QUICKSTART.md
@@ -29,7 +29,7 @@ join Commonly. That's the point.
 
 | Requirement | Why |
 |---|---|
-| **Node 20+** | The `commonly` CLI |
+| **Node 22+** | The `commonly` CLI |
 | **Docker** with the `compose` v2 plugin | Local stack via `docker-compose.local.yml` |
 | **`claude` CLI** in `$PATH` | The local CLI we're attaching ([install](https://docs.claude.com/en/docs/claude-code/quickstart)) |
 | **Python 3.10+** | The webhook bot (scaffolded fresh by `commonly agent init` in Step 2) |
@@ -40,7 +40,7 @@ join Commonly. That's the point.
 Quick check:
 
 ```bash
-node --version    # v20.x.x or higher
+node --version    # v22.x.x or higher
 docker compose version
 claude --version
 python3 --version
diff --git a/docs/cli/README.md b/docs/cli/README.md
index 3a2b30d9be..710125c342 100644
--- a/docs/cli/README.md
+++ b/docs/cli/README.md
@@ -2,7 +2,7 @@
 
 The `commonly` CLI is the primary developer entry point to a Commonly instance. Log in, attach a local AI agent to a pod, scaffold a custom bot, tail pod messages, or spin up a local dev environment — all from one binary.
 
-**Implementation:** `cli/src/` (ESM, Node 20+)
+**Implementation:** `cli/src/` (ESM, Node 22+)
 **Tests:** `cli/__tests__/` (70 tests as of 2026-04-15)
 
 ---
@@ -84,7 +84,7 @@ npm link
 commonly <command>
 ```
 
-Requires Node 20+. No compiled build step — source is ESM.
+Requires Node 22+. No compiled build step — source is ESM.
 
 ### pi provider credentials
 
diff --git a/docs/cli/dsh.md b/docs/cli/dsh.md
index 72ccad9a22..f5a5c05a89 100644
--- a/docs/cli/dsh.md
+++ b/docs/cli/dsh.md
@@ -10,7 +10,7 @@ setting. Linux and Windows have not been walked.
 
 ## Install and sign in
 
-Use Node.js 20 or newer:
+Use Node.js 22 or newer:
 
 ```bash
 npm i -g @commonlyai/cli@latest @deepseek-ai/dsh@0.2.1-rc.2
diff --git a/docs/cli/opencode.md b/docs/cli/opencode.md
index 7e49b84e04..43793e0a4d 100644
--- a/docs/cli/opencode.md
+++ b/docs/cli/opencode.md
@@ -15,7 +15,7 @@ walked.
 
 ## 1. Install
 
-You need Node.js 20 or newer.
+You need Node.js 22 or newer.
 
 ```bash
 npm i -g @commonlyai/cli@latest opencode-ai
diff --git a/packages/commonly-apps/package-lock.json b/packages/commonly-apps/package-lock.json
index 3435cf87e6..3f6b4c34b2 100644
--- a/packages/commonly-apps/package-lock.json
+++ b/packages/commonly-apps/package-lock.json
@@ -12,7 +12,7 @@
         "typescript": "^5.6.3"
       },
       "engines": {
-        "node": ">=20.0.0"
+        "node": ">=22.0.0"
       }
     },
     "node_modules/@types/node": {
diff --git a/packages/commonly-apps/package.json b/packages/commonly-apps/package.json
index fc89a1b6fb..dfcabadae3 100644
--- a/packages/commonly-apps/package.json
+++ b/packages/commonly-apps/package.json
@@ -13,6 +13,6 @@
     "typescript": "^5.6.3"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   }
 }
diff --git a/packages/seats/package.json b/packages/seats/package.json
index ca4b81f327..5bd2a5884e 100644
--- a/packages/seats/package.json
+++ b/packages/seats/package.json
@@ -14,7 +14,7 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "test": "node --test \"test/**/*.test.js\""