Skip to Content
DocsReferenceCLI CommandsFeature Commandsfeature-do

Synopsis

aigon feature-do <ID> [--agent=<cc|gg|cx|cu>] [--iterate] [--max-iterations=N] [--auto-submit] [--no-auto-submit] [--dry-run]

Shortcuts

  • /afd (slash command) · aigon afd (CLI)

Flags

FlagDescription
--agent=<cc|gg|cx|cu>Override agent detection (useful when branch name is ambiguous)
--iterateRun in Autopilot mode: implement → validate → repeat until passing or max iterations
--max-iterations=NMax iterations for --iterate mode (default: 5)
--auto-submitAutomatically run agent-status implementation-complete when done
--no-auto-submitSuppress auto-submit even if configured
--dry-runPrint what would happen without executing

Description

feature-do is the main work step — the command an agent runs inside a feature worktree to implement the spec. It prints the feature spec inline (so the agent doesn’t need to re-read from disk), detects whether you’re in Drive or Fleet mode, and signals the appropriate lifecycle transitions.

You typically don’t call this from the CLI directly. feature-start opens the agent terminal and loads it automatically. Use /aigon:feature-do <ID> inside an agent session when you need to re-attach after a restart, or when launching an agent manually.

What it does

  1. Resolves the feature ID and attaches to the workspace
  2. Prints the spec inline so the agent can work from it without further reads
  3. Signals implementing status to the dashboard
  4. Agent implements the spec, commits incrementally, and runs validation
  5. Agent calls aigon agent-status implementation-complete when done

Iterate mode

With --iterate, Aigon runs an implement-validate loop:

implement → run spec validation → if fail, spawn fresh agent context → repeat

Each iteration uses a clean context window. Add a ## Validation section to your feature spec to define what “passing” means. The loop stops when validation passes or --max-iterations is reached.

aigon feature-do 42 --iterate --max-iterations=3

Examples

# Re-attach to a feature after restarting an agent session
/aigon:feature-do 42
 
# From the CLI with iterate mode
aigon feature-do 42 --iterate
 
# Dry run — print mode and context without executing
aigon feature-do 42 --dry-run
Last updated on
feature-nowfeature-open