Skip to content

tips.md

Latest commit

 

History

History
156 lines (107 loc) · 3.9 KB

tips.md

File metadata and controls

156 lines (107 loc) · 3.9 KB

Codev Tips & Tricks

Practical tips for getting the most out of Codev and Agent Farm.

Skip Permission Prompts

Add --dangerously-skip-permissions to your codev/config.json to reduce permission prompts:

{
  "shell": {
    "architect": "claude --dangerously-skip-permissions",
    "builder": "claude --dangerously-skip-permissions"
  }
}

Warning: Only use this in development environments where you trust the AI's actions.

Resume After a Crash

If the Architect or a Builder crashes, you can pick up where you left off using Claude Code's /resume command:

/resume

This restores the previous conversation context so you don't lose progress.

Run Consultations in Parallel

When running 3-way reviews, launch all consultations in parallel:

consult --model gemini pr 83 &
consult --model codex pr 83 &
consult --model claude pr 83 &
wait

This runs all three in the background simultaneously, saving significant time.

Watch Consultations in Real-Time

By default, the consult command runs in the background. If you want to watch a consultation happen in the dashboard terminal:

af consult --model gemini spec 42

Instead of:

consult --model gemini spec 42

The af consult variant runs in a visible dashboard terminal so you can observe the model's analysis.

Quick Builder Spawning

Spawn a builder directly from a spec number:

af spawn -p 0042

The builder gets its own isolated git worktree, automatically receives the spec and plan context, and starts implementing immediately.

Stage-Specific Reviews

Use the --type flag to get focused review prompts for each stage:

consult --model gemini spec 42 --type spec-review      # Specification review
consult --model codex plan 42 --type plan-review       # Plan review
consult --model claude pr 83 --type integration-review # PR integration review

Available types: spec-review, plan-review, impl-review, pr-ready, integration-review

Mediated Reviews (Faster 3-Way)

For large PRs, prepare context upfront and pass it to consultants:

# Prepare a summary of changes
cat > /tmp/overview.md << 'EOF'
## PR Summary
- Added user authentication
- Modified 5 files
- Key changes: JWT tokens, middleware
EOF

# Run parallel mediated reviews (~30-60s vs 2-4min)
consult --model gemini pr 83 --context /tmp/overview.md &
consult --model codex pr 83 --context /tmp/overview.md &
consult --model claude pr 83 --context /tmp/overview.md &
wait

Custom Templates

Codev templates (protocols, roles, etc.) can be customized by editing files in your local codev/ directory. Local files always take precedence over the embedded skeleton.

For example, to customize the consultant role:

# Edit directly - the file already exists in your project
vim codev/roles/consultant.md

Safe Branch Management

Builders work in isolated git worktrees. Their changes don't affect your main branch until they create a PR and you merge it.

Troubleshooting

Dashboard Won't Start

af stop    # Kill any orphaned processes
af start   # Fresh start

Orphaned Sessions

Nuclear option if things are really stuck:

tmux kill-server  # Kills ALL tmux sessions

Port Conflicts

If you're having port issues across multiple projects:

af ports list     # See all port allocations
af ports cleanup  # Remove stale entries

Database Inspection

View the Agent Farm database state:

af db dump           # Dump local project database
af db dump --global  # Dump global port registry
af db stats          # Show database statistics

Advanced: Architect Knows the Internals

The Architect agent has detailed knowledge of the Agent Farm UI internals, including tmux and ttyd. You can ask it to do interesting things like:

  • Rearrange terminal layouts
  • Send commands to specific panes
  • Create custom dashboard configurations
  • Debug terminal rendering issues