gh-edmundmiller-dotfiles-config-claude-plugins-jj/commands/cleanup.md

allowed-tools, description, model

allowed-tools	description	model
Bash(jj workspace:*), Bash(jj log:*)	Remove empty or stale jj workspaces	claude-haiku-4-5

Context

• Available workspaces: !jj workspace list
• Current workspace: !jj workspace list | grep '*'

Your Task

Clean up empty or stale jj workspaces.

What are jj workspaces?

Jujutsu workspaces allow you to have multiple working copies of your repository simultaneously. Each workspace can work on different revisions independently.

When to use cleanup:

• After finishing work in a temporary workspace
• When you have orphaned workspaces from interrupted work
• To reclaim disk space from unused workspaces
• Regular maintenance to keep workspace list clean

Steps:

1. List all workspaces:

   jj workspace list
   

2. Check each workspace status: For each workspace (except the current one), check if it's empty or stale:

   jj log -r <workspace-name>@ --no-graph -T 'if(empty, "empty", "has_changes")'
   

3. Remove empty/stale workspaces:

   jj workspace forget <workspace-name>
   

Safety notes:

• Never remove the current workspace (marked with *)
• jj workspace forget doesn't delete files, it just removes the workspace tracking
• You can always recreate a workspace if needed
• This is a maintenance operation, not a destructive one

Example workflow:

# List workspaces
jj workspace list
# Output:
# default: sqxoqmn 7a9a3c5 (empty) (no description set)
# * feature-work: rlzxqmpv 0c4a1b2 Add login feature
# old-bugfix: xyz123ab (empty) (no description set)

# Remove empty workspaces
jj workspace forget default
jj workspace forget old-bugfix

# Verify
jj workspace list
# Output:
# * feature-work: rlzxqmpv 0c4a1b2 Add login feature

What if I don't have multiple workspaces?

If you only have one workspace (the default), this command won't do anything. Workspaces are optional - they're useful for:

• Working on multiple features simultaneously
• Code review without switching commits
• Parallel development on different branches

Show final state: !jj workspace list