Worktree Status

Display comprehensive status of all worktrees.

Procedure

Run these commands to gather worktree status:

1. List Active Worktrees

echo "=== Active Worktrees ===" && git worktree list

2. Check for Stale References

echo "=== Stale References ===" && git worktree prune --dry-run 2>&1 || echo "None found"

3. Check Uncommitted Changes Across Worktrees

echo "=== Uncommitted Changes ===" && for wt in $(git worktree list --porcelain | grep "^worktree " | cut -d ' ' -f 2); do
  changes=$(cd "$wt" && git status --porcelain 2>/dev/null | head -5)
  if [ -n "$changes" ]; then
    echo ""
    echo "📁 $wt:"
    echo "$changes"
    count=$(cd "$wt" && git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
    if [ "$count" -gt 5 ]; then
      echo "   ... and $((count - 5)) more files"
    fi
  fi
done
echo ""
echo "Worktrees with no changes not shown."

4. Check for Locked Worktrees

echo "=== Locked Worktrees ===" && for wt in $(git worktree list --porcelain | grep "^worktree " | cut -d ' ' -f 2); do
  if [ -f "$wt/../.git/worktrees/$(basename $wt)/locked" ] 2>/dev/null || git worktree list --porcelain | grep -A5 "^worktree $wt$" | grep -q "^locked"; then
    echo "🔒 $wt"
  fi
done || echo "None"

Output Interpretation

Active Worktrees

/path/to/project              abc1234 [main]
/path/to/project/.worktrees/feature  def5678 [feature/auth]

First column: worktree path
Second column: HEAD commit
Third column: branch name

Stale References

If git worktree prune --dry-run shows output, you have stale entries:

Removing worktrees/old-feature: gitdir file points to non-existent location

Fix: Run git worktree prune to clean up.

Uncommitted Changes

Shows files with uncommitted changes in each worktree:

📁 /path/to/project/.worktrees/feature:
 M src/auth/service.ts
?? src/auth/new-file.ts

Status codes:

M - Modified
A - Added (staged)
D - Deleted
?? - Untracked
UU - Merge conflict

Quick Health Check

Run all checks in one command:

echo "=== WORKTREE STATUS ===" && \
echo "" && \
echo "📋 Active Worktrees:" && \
git worktree list && \
echo "" && \
echo "🧹 Stale References:" && \
(git worktree prune --dry-run 2>&1 | grep -v "^$" || echo "  None") && \
echo "" && \
echo "📝 Uncommitted Changes:" && \
for wt in $(git worktree list --porcelain | grep "^worktree " | cut -d ' ' -f 2); do
  changes=$(cd "$wt" && git status --porcelain 2>/dev/null)
  if [ -n "$changes" ]; then
    echo "  $wt: $(echo "$changes" | wc -l | tr -d ' ') files"
  fi
done && \
echo "" && \
echo "Done."

Recommended Actions

Based on status output:

| Finding | Action | |---------|--------| | Stale references | Run git worktree prune | | Uncommitted changes | Commit, stash, or discard | | Old worktrees | Use /worktrees:finish to clean up | | Locked worktrees | Unlock with git worktree unlock <path> if no longer needed |

Related Skills

/worktrees:new - Create a new worktree
/worktrees:finish - Clean up completed worktree
/worktrees:concepts - Reference documentation