CLI Reference

Commands

Command	Description
`npx buildcrew`	Full interactive setup (agents + Playwright MCP + harness)
`npx buildcrew init`	Generate project harness only
`npx buildcrew init --force`	Regenerate harness (backs up existing)
`npx buildcrew add`	List available harness templates
`npx buildcrew add <type>`	Add a harness template
`npx buildcrew harness`	Show status of all harness files
`npx buildcrew --force`	Overwrite existing agent files
`npx buildcrew --list`	List all 15 agents with models
`npx buildcrew --uninstall`	Remove installed agents
`npx buildcrew --version`	Show version
`npx buildcrew --help`	Full help

Template Types

npx buildcrew add erd              # Database schema
npx buildcrew add architecture     # System architecture
npx buildcrew add api-spec         # API endpoints
npx buildcrew add design-system    # Design tokens & components
npx buildcrew add glossary         # Domain terms
npx buildcrew add user-flow        # User journeys
npx buildcrew add env-vars         # Environment variables

Interactive Setup Flow

When you run npx buildcrew, the CLI walks you through:

Step 1: Install/update 15 agents → .claude/agents/
Step 2: Playwright MCP? (Y/n) → auto-installs if yes
Step 3: Project harness? (Y/n) → scans codebase, generates context
Step 4: Pick templates → choose from available harness files

Version Auto-Update

Agents include version headers (version: 1.8.x). When you run npx buildcrew on an existing project:

New agents are installed automatically
Outdated agents are updated (version compared)
Up-to-date agents are skipped
No --force needed for normal upgrades

Architecture vs gstack