delete

🔸 delete

Command for orchestra members (Git worktrees) to exit the stage. Provides complete cleanup by removing both the worktree directory and associated local branch.

Overview

mst delete <branch-name> [options]
mst rm <branch-name> [options]  # alias

What gets deleted

When an orchestra member exits the stage, Maestro performs a complete cleanup:

1. Worktree directory - The physical directory containing the branch's files
2. Empty parent directories - Any empty directories left behind after worktree deletion
   • Automatically cleans up empty parent directories (useful for branches like feature/api which would leave empty feature/ directory)
   • Recursively removes empty directories up to the repository base directory
   • Provides visual feedback showing which directories were cleaned up with the message: 🧹 Removed empty directory: {directory-name}
3. Local branch - The Git branch associated with the worktree
   • First attempts safe deletion with git branch -d
   • Automatically retries with git branch -D if the branch is not fully merged
   • Ensures complete cleanup without manual intervention
4. tmux session - The tmux session with the same name as the worktree (if exists)
   • Default behavior: Automatically terminates the session when deleting the worktree
   • Session names are normalized to handle special characters (e.g., feature/api-auth becomes feature-api-auth)
   • Use --keep-session to preserve the tmux session after deletion

This ensures no orphaned branches, sessions, or empty directories remain after worktree deletion.

Usage Examples

Basic Usage

# Orchestra member exits the stage (removes both worktree and local branch)
mst delete feature/old-feature

# Force exit (even with uncommitted changes)
mst delete feature/old-feature --force

# Keep tmux session after worktree exits
mst delete feature/old-feature --keep-session

# Select with fzf for exit
mst delete --fzf