lilyshen0722 · Oct 30, 2026
diff --git 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
@@ -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
diff --git 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
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
diff --git 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
@@ -14,7 +14,7 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "test": "node --test \"test/**/*.test.js\""
-Original file line number
+Diff line change
@@ Expand Up / @@ -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
@@ Expand Down @@