Agent Farm CLI
af spawn
Spawns a new builder in an isolated git worktree.
af spawn [number] [options]The ONLY flags that exist:
| Flag | Description |
|---|---|
--protocol <name> | Protocol: spir, aspir, air, bugfix, tick, maintain, experiment. Required for numbered spawns. |
--task <text> | Ad-hoc task (no issue number needed) |
--shell | Bare Claude session |
--worktree | Bare worktree session |
--amends <number> | Original spec number (TICK only) |
--files <files> | Context files, comma-separated. Requires --task. |
--no-comment | Skip commenting on the GitHub issue |
--force | Skip dirty-worktree and collision checks |
--soft | Soft mode (AI follows protocol, you verify) |
--strict | Strict mode (porch orchestrates) — this is the default |
--resume | Resume builder in existing worktree |
--no-role | Skip loading role prompt |
There is NO -t, --title, --name, or --branch flag. The branch name is auto-generated from the issue title.
Examples:
af spawn 42 --protocol spir # SPIR builder for issue #42
af spawn 42 --protocol aspir # ASPIR (autonomous, no human gates)
af spawn 42 --protocol air # AIR (small features)
af spawn 42 --protocol bugfix # Bugfix
af spawn 42 --protocol tick --amends 30 # TICK amendment to spec 30
af spawn 42 --protocol spir --soft # Soft mode
af spawn 42 --resume # Resume existing builder
af spawn --task "fix the flaky test" # Ad-hoc task (no issue)
af spawn 42 --protocol spir --force # Skip dirty-worktree checkPre-spawn checklist:
git status— worktree must be clean (or use--force)- Commit specs/plans first — builders branch from HEAD and can't see uncommitted files
--protocolis required for numbered spawns
af send
Sends a message to a running builder.
af send [builder] [message]| Flag | Description |
|---|---|
--all | Send to all builders |
--file <path> | Include file content |
--interrupt | Send Ctrl+C first |
--raw | Skip structured formatting |
--no-enter | Don't press Enter after message |
af send 0042 "PR approved, please merge"
af send 0585 "check the test output" --file /tmp/test-results.txtaf cleanup
Removes a builder's worktree and branch after work is done.
af cleanup [options]| Flag | Description |
|---|---|
-p, --project <id> | Builder project ID (no leading zeros: 585 not 0585) |
-i, --issue <number> | Cleanup bugfix builder by issue number |
-t, --task <id> | Cleanup task builder (e.g., task-bEPd) |
-f, --force | Force cleanup even if branch not merged |
af cleanup -p 585 # Clean up project 585
af cleanup -p 585 -f # Force (unmerged branch)Note: af cleanup uses plain numbers (585), not zero-padded (0585). But af send uses zero-padded IDs (0585).
af status
af status # Show all builders and workspace statusNo flags needed. Shows Tower status, workspace, and all active builders.
af tower
af tower start # Start Tower on port 4100
af tower stop # Stop Tower
af tower log # Tail Tower logs
af tower status # Check daemon and cloud connection status
af tower connect # Connect to Codev Cloud
af tower disconnect # Disconnect from Codev CloudThere is NO af tower restart — use af tower stop && af tower start.
af workspace
af workspace start # Start workspace for current project
af workspace stop # Stop workspace processesaf dash is a deprecated alias — use af workspace instead.
af cron
af cron list # List all cron tasks
af cron status <name> # Check task status
af cron run <name> # Run immediately
af cron enable <name> # Enable
af cron disable <name> # DisableThere is NO af cron add — create YAML files in .af-cron/ directly.
Other commands
af open <file> # Open file in annotation viewer (NOT system open)
af shell # Spawn utility shell
af attach # Attach to running builder terminal
af rename <name> # Rename current shell session
af architect # Start architect session in current terminal