feature-cleanup

aigon-feature-cleanup

Remove all worktrees and branches for a feature. Useful after completing a Fleet run or when canceling a feature.

Usage

# Delete worktrees and local branches
aigon feature-cleanup {{args}}

# Push branches to origin before deleting
aigon feature-cleanup {{args}} --push

Argument Resolution

If no ID is provided, or the ID doesn't match an existing feature:

1. Run aigon feature-list --active
2. If a partial ID or name was given, filter to matches
3. Present the matching features and ask the user to choose one

What Gets Cleaned Up

This command removes:

• All worktrees for the feature (e.g., ../feature-55-cc-desc, ../feature-55-ag-desc)
• All local branches for the feature
• Worktree permissions from Claude settings

Options

--push Flag

Use --push to preserve branches on the remote before deleting locally:

aigon feature-cleanup 55 --push

This will:

1. Push each branch to origin
2. Delete local branches
3. Remove worktrees

Without --push, branches are only deleted locally.

When to Use

After Fleet Completion

After running aigon feature-close 55 <agent> to merge the winning implementation, clean up the losing implementations:

aigon feature-cleanup 55

Canceling a Feature

If you want to abandon a feature that was set up in Fleet mode:

aigon feature-cleanup 55 --push    # Preserve work on remote
# or
aigon feature-cleanup 55           # Delete everything

Important Notes

• This command is destructive - deleted worktrees and branches cannot be easily recovered
• Use --push if you want to preserve the work on the remote repository
• The command will remove ALL branches matching feature-<ID>-*
• For Drive mode features, this will delete the feature branch (use with caution)
• Logs and specs in docs/specs/features/ are NOT deleted