Prerequisites

System requirements and setup

Prerequisites

Prompt-first procedure: Describe the outcome you want in your agent conversation. The agent should select and load the appropriate AIWG assets, explain material changes, request any needed approval, and report verification evidence. Exact commands and flags appear only in the CLI reference.

First time using AIWG? Begin with Install, Connect, and Verify. This guide assumes

AIWG is connected to the target project and your provider session can read the deployed context.

Before installing AIWG, ensure you have the following requirements.

Required

Node.js ≥24

node the version option  # Should show v24.x.x or higher
npm the version option

AIWG requires Node 24 or newer. Node 24 is the standard runtime for all installs.

Contributor and release workflows have stricter npm requirements:

Use case	Requirement	Why
Install and run AIWG	Node 24+	Matches the package `engines.node` floor
Change dependencies or regenerate lockfiles	npm 11.5+	Required for the committed `min-release-age=7` gate
Publish AIWG releases	Node 24 in the release workflow	Current npm 11.x plus npm trusted-publishing support

Reuse a healthy Node version manager if one is already installed. Do not stack `nvm`, `fnm`, `asdf`, `mise`, Volta, or another manager. If no manager exists, the new-user defaults are `nvm-sh` on macOS, Linux, and WSL, and `nvm-windows` on native Windows. See Install Node.js and npm Safely for the platform-specific checks and official installation sources.

macOS users should start with the macOS Install Guide. npm's own documentation recommends a Node version manager on macOS to avoid global-package permission errors such as `EACCES` under `/usr/local/lib/node_modules`.

AI Platform (Choose One or More)

Platform	Best For	Install
Claude Code	Multi-agent orchestration, artifact generation	claude.ai/code
Warp Terminal	Terminal-native AI, command-line workflows	warp.dev
Factory AI	Custom droid workflows	factory.ai
Cursor	IDE-native rules	cursor.sh
GitHub Copilot	GitHub integration	VS Code extension

After Node and an AI platform are available, continue with Install, Connect, and Verify. Teams that use more than one provider can repeat the deployment step for each provider:

Use AIWG to complete this documented outcome: After Node and an AI platform are available, continue with Install, Connect, and Verify. Teams that use more than one provider can repeat the deployment step for each provider
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

Provider Deployment Surface

Platform	Notes
Claude Code	Multi-agent orchestration and native plugin paths
GitHub Copilot	`copilot-instructions.md` and GitHub-facing context
Warp Terminal	Terminal-native workflows
Factory AI	Native droid format and `AGENTS.md`
OpenCode	`AGENTS.md` and OpenCode paths
Cursor	Native rules format and `AGENTS.md`
OpenAI/Codex	Native prompts format and `AGENTS.md`
Devin Desktop	Uses the `.windsurf/` compatibility adapter; select with `devin`

Operating Systems

OS	Status
macOS (Intel + Apple Silicon)	✅ Supported
Linux (Ubuntu, Debian, Fedora, Arch, RHEL)	✅ Supported
WSL2 (Windows Subsystem for Linux)	✅ Supported
Native Windows (PowerShell)	✅ Supported

Optional (Recommended)

Git

Required for the agent-owned -new operation project scaffolding and version control.

git the version option

# Install if needed:
# macOS: brew install git
# Ubuntu: sudo apt-get install git
# Fedora: sudo dnf install git

Quick Compatibility Check

# Check Node.js and npm
node the version option && echo "Node.js present" || echo "Node.js missing"
npm the version option && echo "npm present" || echo "npm missing"

# Check Claude Code (if using)
claude the version option 2>/dev/null && echo "✅ Claude Code" || echo "ℹ️ Claude Code not installed"

# Check Factory AI (if using)
factory the version option 2>/dev/null && echo "✅ Factory AI" || echo "ℹ️ Factory AI not installed"

# Check Git (optional)
git the version option && echo "✅ Git" || echo "ℹ️ Git optional"

All checks passed? Continue to Install, Connect, and Verify.