Skip to content
Arashi

remove Command

What It’s For

Clean up feature branches and worktrees when work is done or abandoned.

What It Does

  • Removes matching worktree directories from the workspace.
  • Can also delete corresponding Git branches.
  • Supports safety checks for dirty worktrees and optional force behavior.

Usage

Terminal window
arashi remove [target] [options]

Key Options

  • --no-check-dirty skip uncommitted changes checks.
  • --keep-worktrees delete branches but keep worktree directories.
  • --keep-branches remove worktrees but keep branches.
  • -f, --force skip confirmation prompts.
  • --path treat target as a worktree path.
  • --json output machine-readable results.

Examples

Terminal window
# Remove a branch across managed repositories
arashi remove feature-login


# Interactive selection mode
arashi remove


# Remove by path
arashi remove ./repos/api/feature-login --path

Notes

  • Main worktrees are skipped automatically.
  • If both --keep-worktrees and --keep-branches are set, no operation is performed.
  • Dirty worktrees require explicit confirmation unless --no-check-dirty is used.