Agent Farm Quick Reference

Tower (Dashboard Server)

af tower start             # Start Tower on port 4100
af tower stop              # Stop Tower
af tower log               # Tail Tower logs
af tower status            # Check if Tower is running

There is NO af tower restart — use af tower stop && af tower start.

Dashboard

af dash start              # Start architect dashboard for current project
af dash stop               # Stop dashboard for current project
af dash open               # Open dashboard in browser

Builder Management

af spawn 3 --protocol spir     # Spawn builder for SPIR project
af spawn 3 --protocol spir --soft  # Spawn builder (soft mode)
af spawn 3 --protocol bugfix   # Spawn builder for a bugfix
af spawn 3 --resume            # Resume builder in existing worktree
af status                      # Check all builder status
af cleanup --project 3         # Clean up builder worktree (safe)
af cleanup --project 3 -f      # Force cleanup

Resuming Builders

When a builder's Claude process dies but the worktree and porch state survive, use --resume to restart it without recreating the worktree:

af spawn 3 --resume

This reuses the existing .builders/3 worktree, creates a fresh terminal session registered with the Tower (so it appears in the dashboard), and lets porch pick up from whatever phase the builder was in. Works with all spawn modes: positional issue number, --task, --protocol, --worktree.

Utility

af util                    # Open utility shell
af open file.ts            # Open file in annotation viewer
af ports list              # List port allocations
af send <builder> "msg"    # Send message to a builder

Configuration

Edit af-config.json at project root to customize shell commands.

{
  "shell": {
    "architect": "claude",
    "builder": "claude",
    "shell": "bash"
  }
}

Pre-Spawn Checklist

Before af spawn, commit all local changes. Builders work in git worktrees branched from HEAD — uncommitted files (specs, plans, codev updates) are invisible to the builder. The spawn command will refuse if the worktree is dirty (override with --force).

Common Mistakes

• Spawning with uncommitted changes — builder won't see specs, plans, or codev updates
• There is NO codev tower command — Tower is managed via af tower
• There is NO restart subcommand — stop then start
• There is NO af start for Tower — use af tower start or af dash start