Command Reference

Complete reference for all squads-cli commands with real examples from production.

Overview & Status

squads status

View all squads with agent counts, memory state, and last activity.

terminal
$ squads status
Output:
  squads status
  ● 7 active sessions across 1 squad (claude 7)

  11/11 squads  │  memory: enabled

  ┌────────────────────────────────────────────────────────┐
  │ SQUAD           AGENTS  MEMORY        ACTIVITY         │
  ├────────────────────────────────────────────────────────┤
  │ analytics       1       none          —                │
  │ cli             8       3 entries     today            │
  │ company         2       1 entry       yesterday        │
  │ customer        4       3 entries     today            │
  │ engineering     6       1 entry       today            │
  │ finance         2       1 entry       3d ago           │
  │ intelligence    24      1 entry       today            │
  │ marketing       4       2 entries     2d ago           │
  │ product         2       1 entry       today            │
  │ research        6       1 entry       7d ago           │
  │ website         10      1 entry       today            │
  └────────────────────────────────────────────────────────┘

  $ squads status <squad>    Squad details
  $ squads dash              Full dashboard
  $ squads run <squad>       Execute a squad

squads status <squad>

Drill down into a specific squad's details, agents, and memory.

terminal
$ squads status intelligence
Output:
  Gather intelligence that drives business decisions — competitive
  landscape, market dynamics, and enterprise adoption patterns.

  Agents (24)

  ┌────────────────────────────────────────────────────────────────┐
  │ ○ ANALYTICS_ROADMAP                                            │
  │ ○ agent-frameworks-monitor                                     │
  │ ○ anthropic-monitor                                            │
  │ ○ data-architect                                               │
  │ ○ enterprise-ai-monitor                                        │
  │ ○ industry-scanner                                             │
  │ ○ intel-lead                                                   │
  │ ○ market-discovery                                             │
  │ ○ signal-hunter                                                │
  └────────────────────────────────────────────────────────────────┘

  Memory (1 entry)

  ◆ intel-lead
    └ updated: 2026-01-06

  $ squads run intelligence           Run the squad
  $ squads memory show intelligence   View full memory

squads dash

Full dashboard with metrics, git activity, token economics, and goals.

terminal
$ squads dash
Shows:
  • Goal progress tracking across all squads
  • Git activity sparklines (last 14 days)
  • Token economics and costs (today, week)
  • Rate limits monitoring
  • Infrastructure status (postgres, redis, otel)
  • Active goals preview

Execution

squads run <squad>

Execute all agents in a squad based on their SQUAD.md configuration.

terminal
$ squads run intelligence
What it does:
  • 1. Reads SQUAD.md to determine which agents to run
  • 2. Loads each agent's .md file with instructions
  • 3. Executes via Claude Code or GitHub Actions
  • 4. Outputs to domain repository

squads run <squad>/<agent>

Execute a specific agent instead of the entire squad.

terminal
$ squads run intelligence/intel-lead

Memory

Memory = Your Cross-Session Brain. Without memory, every session starts fresh. With memory, you build on previous work.

squads memory query "<topic>"

Semantic search across all squad memory (not keyword matching).

terminal
$ squads memory query "analytics"
Output:
  5 results found

  ┌──────────────────────────────────────────────────┐
  │ LOCATION                    TYPE      SCORE      │
  ├──────────────────────────────────────────────────┤
  │ intelligence/intel-lead     state     7.2        │
  │ marketing/marketing-lead    state     7.2        │
  │ product/product-lead        state     7.2        │
  │ website/web-lead            state     7.2        │
  │ intelligence/intel-lead     output    6.0        │
  └──────────────────────────────────────────────────┘

  Matches

  ◇ | Claude Code | 2026-01-04 | 80.9% SWE-bench score…
    └ intelligence/intel-lead
  ◇ - feat(intelligence): analytics roadmap…
    └ intelligence/intel-lead

squads memory show <squad>

View full memory for a specific squad.

terminal
$ squads memory show intelligence

squads memory update <squad>

Update squad memory (typically done automatically via state files).

terminal
$ squads memory update intelligence

Goals

squads goal list

List all goals across all squads with progress indicators.

terminal
$ squads goal list
Output:
  cli
  Build and maintain the Squads CLI…

  ● [2] Add `squads baseline` command for before/after metrics
  ● [3] Improve dashboard with cost projections

  customer
  Manage customer relationships…

  ● [1] Identify 10 qualified leads
  ● [2] Contact 5 HOT leads by Jan 10

  23 active  │  7 completed

squads goal set <squad> "<goal>"

Set a new goal for a squad.

terminal
$ squads goal set cli "Add baseline command"

squads goal complete <squad>

Mark a goal as complete (interactive selector).

terminal
$ squads goal complete cli

Triggers

Smart Triggers = Value-Driven Execution. Agents fire automatically based on Postgres conditions (cost alerts, metrics thresholds, etc.).

squads trigger list

List all triggers configured in SQUAD.md files.

terminal
$ squads trigger list

squads trigger sync

Sync trigger definitions from SQUAD.md files to Postgres.

terminal
$ squads trigger sync

squads trigger status

Check scheduler health and trigger execution stats.

terminal
$ squads trigger status

Feedback

squads feedback add <squad>

Record execution feedback for a squad run.

terminal
$ squads feedback add intelligence

squads feedback show <squad>

View feedback history for a squad.

terminal
$ squads feedback show intelligence

squads feedback stats

View aggregate feedback statistics across all squads.

terminal
$ squads feedback stats

Authentication

Authentication commands for Squads Pro and Enterprise tiers. These enable cloud sync, team collaboration, and advanced features.

squads login

Log in to Squads cloud (Pro/Enterprise only).

terminal
$ squads login

squads whoami

Show current authenticated user.

terminal
$ squads whoami

What's Next?