How to fix error: Cannot delete branch 'feature' checked out at '/path/to/repo' in Git

What this error means

The "Cannot delete branch checked out" error is a safety mechanism in Git that prevents you from deleting a branch you're currently working on. When you're on a branch, Git has that branch's commit as your current HEAD, and your working directory contains that branch's files. If Git allowed you to delete the checked-out branch, your working directory would be left in an inconsistent state: you'd have files from a branch that no longer exists, and Git wouldn't know which commit your working directory represents. This error can appear in two scenarios: 1. **Direct checkout**: You're trying to delete the branch you're currently on in your main working directory. 2. **Worktree checkout**: The branch is checked out in a secondary worktree. Git's worktree feature allows you to have multiple working directories attached to a single repository, each with a different branch checked out. You cannot delete a branch that has any worktree associated with it. The error message helpfully tells you the path where the branch is checked out, which helps you identify whether it's your current directory or a separate worktree location.

Typical symptoms

• Running 'git branch -d <branch>' fails with 'Cannot delete branch' error
• Error message shows a path that may not be your current directory
• Force delete with 'git branch -D' also fails with the same error
• The branch appears in 'git branch' output but cannot be removed
• Switching branches doesn't resolve the error (worktree case)
• CI/CD cleanup scripts fail when trying to delete feature branches

Common causes

1. You are currently on the branch you're trying to delete
2. The branch is checked out in a separate Git worktree
3. A worktree directory was manually deleted but Git still tracks it
4. An interrupted rebase or bisect operation has the branch checked out
5. Multiple terminal sessions have the same repo open with different branches

How to fix "error: Cannot delete branch 'feature' checked out at '/path/to/repo'"

# See your current branch
git status

# Or use git branch to see all branches with current marked
git branch

main
* feature    <-- You're on this branch
  develop

# Switch to main branch
git checkout main
# Or using the newer switch command (Git 2.23+)
git switch main

# Now delete the branch
git branch -d feature

# Force delete an unmerged branch
git branch -D feature

# List all worktrees
git worktree list

/home/user/project           abc1234 [main]
/home/user/project-feature   def5678 [feature]

# Remove a worktree (this doesn't delete the branch)
git worktree remove /path/to/worktree

# Or if the worktree directory is already deleted
git worktree prune

# Now you can delete the branch
git branch -d feature

# Navigate to the worktree
cd /path/to/worktree

# Switch to a different branch in that worktree
git checkout main

# Go back to main repo and delete the branch
cd /path/to/main/repo
git branch -d feature

# Prune references to worktrees that no longer exist
git worktree prune

# Verify the worktree is gone
git worktree list

# Now try deleting the branch again
git branch -d feature

git status

# Complete or abort the rebase
git rebase --continue
# Or
git rebase --abort

# End the bisect session
git bisect reset

# Detach HEAD by checking out the current commit
git checkout --detach

# Or checkout a specific commit
git checkout HEAD~0

# Now delete the branch
git branch -d feature

# Create a new branch from the current state
git checkout -b new-branch

Advanced notes

# Create a new worktree
git worktree add ../project-hotfix hotfix-branch

# List all worktrees
git worktree list

# Remove a worktree properly
git worktree remove ../project-hotfix

# Inspect worktree metadata
ls -la .git/worktrees/

# Manual cleanup (use with caution)
rm -rf .git/worktrees/stale-worktree

# Delete a remote branch
git push origin --delete feature

# Or using the shorter syntax
git push origin :feature

#!/bin/bash
branch="feature"

# Check if branch is checked out in any worktree
if git worktree list | grep -q "\[$branch\]"; then
    echo "Branch $branch is checked out in a worktree"
    exit 1
fi

# Check if it's the current branch
current=$(git rev-parse --abbrev-ref HEAD)
if [ "$current" = "$branch" ]; then
    echo "Cannot delete current branch, switching to main"
    git checkout main
fi

git branch -d "$branch"

Frequently asked questions

What does "error: Cannot delete branch 'feature' checked out at '/path/to/repo'" mean?

The "Cannot delete branch checked out" error is a safety mechanism in Git that prevents you from deleting a branch you're currently working on. When you're on a branch, Git has that branch's commit as your current HEAD, and your working directory contains that branch's files. If Git allowed you to delete the checked-out branch, your working directory would be left in an inconsistent state: you'd have files from a branch that no longer exists, and Git wouldn't know which commit your working directory represents.

How do I fix "error: Cannot delete branch 'feature' checked out at '/path/to/repo'"?

This error occurs when you try to delete a Git branch that is currently checked out in your working directory or in a linked worktree. Git prevents this to avoid leaving your repository in an undefined state. The solution is to switch to a different branch first, or remove the associated worktree if using multiple working directories.

What causes "error: Cannot delete branch 'feature' checked out at '/path/to/repo'"?

You are currently on the branch you're trying to delete The branch is checked out in a separate Git worktree A worktree directory was manually deleted but Git still tracks it

Is the "error: Cannot delete branch 'feature' checked out at '/path/to/repo'" error serious?

It is a low-severity error — more of a blocker than a risk. The steps above resolve it.

Related errors

• error: tag 'v1.0.0' not found / remote rejected (pre-receive hook declined)

  How to fix errors when deleting Git tags

  LOW

• fatal: Not a valid object name: 'HEAD'

  How to fix "fatal: Not a valid object name: HEAD" in Git

  MEDIUM

• error: Merging is not possible because you have unmerged files

  How to fix 'Merging is not possible because you have unmerged files' in Git

  MEDIUM

• error: refs/heads/main exists; cannot create

  How to fix 'refs/heads/main exists; cannot create' in Git Bundle

  LOW

• API rate limit exceeded

  How to fix 'API rate limit exceeded' in GitHub

  MEDIUM

• fatal: destination path already exists and is not an empty directory

  Destination Path Already Exists and Is Not Empty

  LOW

Official resources & further reading

• 📚Git Official Documentation
• 📖
  git-branch Documentation(Official Docs)
• 📖
  git-worktree Documentation(Official Docs)
• 💬
  How can I delete the current Git branch? - Stack Overflow(Stack Overflow)
• 📖
  Cannot delete branch 'X' checked out at 'X' [SOLVED] - GoLinuxCloud(Official Docs)
• 📖
  Resolving 'Cannot Delete Branch Checked Out' Error in Git - LabEx(Official Docs)
• 💬
  How to delete a git working tree branch - Stack Overflow(Stack Overflow)