aigon-feature-cleanup

name	aigon-feature-cleanup
description	Cleanup feature <ID> [--push] - remove all worktrees and branches

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 $1

# Push branches to origin before deleting
aigon feature-cleanup $1 --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-gg-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