removing-worktree

You can safely remove a git worktree while preserving the branch by deleting the working directory and pruning stale references. This ensures the branch and all commits remain intact in the repository history for future access.

The best way to clean up an autonomy worktree after a strategy completes is removing the .worktrees/autonomy directory and pruning references. This preserves the autonomy branch and iteration history without altering git history.

To force remove a broken git worktree that fails safety checks, use the --force option to bypass validations. This executes git worktree remove and prune directly, clearing broken directories when standard safety checks fail.

Removing a worktree directory does not alter your existing git commit history. The process only deletes the working directory itself, ensuring the associated autonomy branch and all iteration commits are fully preserved.

You should use git worktree prune immediately after removing a working directory to clean up stale administrative references. Running prune ensures the repository state remains accurate after the worktree directory is deleted.