Squad Command Reference

Run squad commands inside the agent user’s active Herdr session. Enter the intended project directory first. Use squad --help to check the interface installed on your computer.

Main commands

Command	Purpose
`squad status`	Show agents reported by Herdr.
`squad delegate`	Start a named worker with an assignment.
`squad debate "topic"`	Run a two-peer analysis using configured roles.
`squad debate resume DEBATE_ID`	Resume a debate from its saved state when supported.

Delegate with a configured role

squad delegate --name docs-worker --role implementation --prompt "Review the project README and implement the agreed documentation corrections."

Use --role review for a reviewer. A role selects its saved agent and model when you omit --kind. If the role is Ask when orchestrating, choose it for the task or configure it in Settings first.

The output can include the agent name, pane, state, recent output, and timeout or blocked indicators. Inspect the actual work; a returned response alone does not prove completion.

Run a debate

squad debate "Compare the proposed cache designs without changing files." --rounds 3

--rounds accepts 1–8. --cwd DIR sets the debate’s project directory. --agents KIND_A,KIND_B explicitly overrides its peer agent choices.

Advanced overrides

Delegation supports --kind KIND and arguments after -- for the selected CLI. These are explicit overrides; use the installed provider’s help to verify them. Do not copy another agent’s model or permission flags.

See role configuration, delegation and review, and debate recovery.