Skip to content

Docs: align Node.js version to >=20 LTS #305

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bradygaster merged 2 commits into from
Mar 10, 2026
Merged

Docs: align Node.js version to >=20 LTS #305

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
90a3328
docs: align Node.js version to >=20 LTS across all docs
diberry Mar 9, 2026
4c7b7e0
Merge branch 'main' into squad/302-align-node-version
diberry Mar 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ The documentation site for Squad, built with [Astro](https://astro.build/), [Tai

## Prerequisites

- Node.js 22+
- Node.js 20+ (LTS)
- Run `npm install` from the `docs/` directory

## Commands
Expand Down
2 changes: 1 addition & 1 deletion docs/src/content/docs/features/vscode.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ This guide covers what's different, what's the same, and when to use CLI vs VS C
- **VS Code** — Latest version
- **GitHub Copilot extension** — `GitHub.copilot` (installed, authenticated)
- **Workspace trust** — Your workspace must be trusted (VS Code security)
- **Node.js 22+** — If running CLI to initialize Squad
- **Node.js 20+ (LTS)** — If running CLI to initialize Squad
- **Squad installed** — Either in the repo already (from CLI), or initialized fresh via agent selection

### Initial Setup
Expand Down
4 changes: 2 additions & 2 deletions docs/src/content/docs/guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ npx github:bradygaster/squad
```

**Requirements:**
- Node.js 22+
- Node.js 20+ (LTS)
- GitHub Copilot (CLI, VS Code, Visual Studio, or Coding Agent)
- A git repository (Squad stores team state in `.ai-team/`)
- **`gh` CLI** — required for GitHub Issues, PRs, Ralph, and Project Boards ([install](https://cli.github.com/))
Expand Down Expand Up @@ -438,7 +438,7 @@ The coordinator uses 6.6% of its window. A 12-week veteran agent uses 4.5% — b
- **Experimental** — file formats and APIs may change between versions.
- **Silent success bug** — approximately 7–10% of background agent spawns complete all their file writes but return no text response. This is a platform-level issue. Squad detects it by checking the filesystem for work product and reports what it finds. Work is not lost.
- **Platform latency** — response times depend on the Copilot platform. Complex multi-agent tasks take 40–60 seconds. Simple questions are answered in 2–3 seconds.
- **Node 22+** — requires Node.js 22.0.0 or later.
- **Node 20+** — requires a Node.js LTS release (v20.0.0 or later).
- **GitHub Copilot required** — Squad works across Copilot hosts (CLI, VS Code, Visual Studio, Coding Agent).
- **First session is the least capable** — agents improve as they accumulate history. Give it a few sessions before judging.

Expand Down
8 changes: 4 additions & 4 deletions docs/src/content/docs/scenarios/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,17 +62,17 @@ Common issues and fixes for Squad installation and usage.

**Problem:** `npx github:bradygaster/squad` fails with an engine compatibility error, or Squad behaves unexpectedly.

**Cause:** Squad requires Node.js 22.0.0 or later (enforced via `engines` in `package.json`).
**Cause:** Squad requires Node.js 20.0.0 or later (LTS), enforced via `engines` in `package.json`.

**Fix:**

```bash
node --version
```

If below v22, upgrade Node.js:
- **nvm (macOS/Linux):** `nvm install 22 && nvm use 22`
- **nvm-windows:** `nvm install 22 && nvm use 22`
If below v20, upgrade to the latest LTS:
- **nvm (macOS/Linux):** `nvm install --lts && nvm use --lts`
- **nvm-windows:** `nvm install lts && nvm use lts`
- **Direct download:** [nodejs.org](https://nodejs.org/)

---
Expand Down