Skip to content

The delete command performs a full teardown of a worktree: kills its tmux session, removes the git worktree, and clears status tracking data.

Usage ​

bash
owt delete <name> [OPTIONS]

Alias: owt rm

Arguments ​

ArgumentDescription
nameWorktree name or branch name to delete

Options ​

OptionDescription
-f, --forceForce deletion even with uncommitted changes
-y, --yesSkip confirmation prompt

Examples ​

Basic Deletion ​

bash
owt delete add-auth

Output:

Delete worktree 'add-auth'? [y/N] y
✓ Killed tmux session: owt-add-auth
✓ Removed worktree at /Users/you/projects/my-app-add-auth
✓ Cleared status tracking
✓ Worktree deleted successfully

Skip Confirmation ​

bash
owt delete add-auth --yes

Force Delete with Uncommitted Changes ​

bash
owt delete add-auth --force

Warning: This discards any uncommitted changes in the worktree.

Combine Flags ​

bash
# Force delete without confirmation
owt delete add-auth -f -y

What Gets Deleted ​

When you delete a worktree, Open Orchestrator performs a full teardown:

  1. tmux session -- Killed if it exists
  2. Git worktree -- Directory and git reference removed
  3. Status tracking -- All tracking data cleared

The git branch itself is NOT deleted. Your commits remain in the repository.

Safety Checks ​

Cannot Delete Main Worktree ​

Error: Cannot delete the main worktree

The main worktree is always protected from deletion.

Uncommitted Changes ​

By default, deletion fails if the worktree has uncommitted changes:

Error: Worktree has uncommitted changes. Use --force to override.

Options:

  • Commit or stash your changes first
  • Use --force to discard changes

Recovering After Deletion ​

Git data (commits, branches) are NOT deleted. The branch still exists:

bash
# Check that the branch still exists
git branch -a | grep add-auth

# Recreate the worktree from the existing branch
owt new "continue auth work" --branch feature/add-auth

See Also ​