Skip to main content
This reference is generated from the CLI’s own command registry, so it always matches the installed version. Verify yours with squads version.

squads init

Plant the seed: create manager agent, CLI skill, and starter squads

squads run

Run a squad or agent: squads run <squad>/<agent> (also: <squad> <agent>). No target lists squads; —org runs all squads as one coordinated cycle.

squads domains

Per-domain scorecard: goals, delivered (merged PRs + closed issues), in flight

squads pause

Pause a squad — run/org/cron dispatch will refuse until resumed

squads resume

Resume a paused squad

squads env

View what a squad run uses: tool integrations (MCP), skills, model, and cost budget

squads env show

Show execution environment for a squad

squads env prompt

Output ready-to-use prompt for Claude Code execution

squads dashboard

Show dashboards. Use “squads dash” for overview, “squads dash <name>” for specific dashboard, “squads dash —list” to see all.
Aliases: squads dash

squads status

Show squad status and state

squads board

Day-scoped execution board: tiles, live runs, executions, incoming queue

squads usage

Show local cost/token usage (today, rolling window, by squad)

squads report

Generate an evidence pack from local observability (default: auditor)

squads doctor

Check local tools, auth, and project readiness

squads plan

Roadmap from the plan-of-record issue: done / ready / blocked, with blockers

squads goal

Manage squad goals

squads goal set

Set a goal for a squad

squads goal list

List goals for squad(s)

squads goal complete

Mark a goal as completed

squads goal progress

Update goal progress

squads feedback

Record and view execution feedback

squads feedback add

Add feedback for last execution (rating 1-5)

squads feedback show

Show feedback history

squads feedback stats

Show feedback summary across all squads

squads memory

Query and manage squad memory

squads memory query

Search across all squad memory

squads memory read

Show memory for a squad

squads memory write

Add to squad memory

squads memory list

List all memory entries

squads memory sync

Sync memory from git: pull remote changes, process commits, optionally push to Postgres
Search stored conversations (requires authentication: squads login)

squads memory extract

Extract memories from recent conversations into Engram

squads logout

Log out from Squads

squads whoami

Show current logged in user

squads contract

Define what each agent is allowed to do — permissions and guardrails, checked automatically

squads contract validate

Derive + validate every agent contract; non-zero exit on any violation

squads brief

Morning catch-up: delivered work, pending approvals, active agents

squads config

View and switch environment configuration (local, staging, prod)

squads config use

Switch to a named environment (local, staging, prod)

squads config show

Show current environment config and resolved URLs

squads providers

Show available LLM CLI providers (claude, gemini, codex, etc.)

squads update

Check for and install updates

squads version

Show version information

squads runs

List live background agent runs (pid-file inventory)

squads inbox

Everything waiting on a human decision — list, or approve/reject/defer <id>

squads propose

Draft one extra deliverable on a proposal branch you review before it lands — scoped, and never leaves your machine

squads scoreboard

Compare models and executors by quality per cost, with the source of every number shown (read-only)

squads kill

Stop a background run gracefully (pid, squad, or squad/agent)

squads commands

List the live command tree (machine-readable with —json)