Search

PythonReactSEOPDF
GitHub Skill

workers

List all active Claude workers and their git worktrees. Shows branch status, commits, and suggests next actions. Use to see what workers are running.

schmug☆ 0 Repository stars0 Repository forks

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

View source ↗Guides

Skill instructions

Workers Skill

List and manage active Claude workers.

Usage

/workers

Instructions

When the user invokes /workers, show the status of all worktrees and workers:

1. List Git Worktrees
git worktree list
2. Show Worker Details

For each worktree (excluding main):

  • Branch name and last commit
  • Files changed vs main
  • Whether it's ahead/behind main
# For each worktree branch
git log <branch> --oneline -1
git diff main...<branch> --stat | tail -1
git rev-list --left-right --count main...<branch>
3. Format Output

Display as a table:

| Worktree | Branch | Last Commit | Changes | Status |
|----------|--------|-------------|---------|--------|
| ../artemis-issue-42 | feat/issue-42-retry | abc123 Add retry | 3 files | +2 ahead |
| ../artemis-feat-logging | feat/add-logging | def456 Add logs | 5 files | +1 ahead |
4. Suggest Actions

Based on status, suggest:

  • Workers with commits → "Ready for PR?"
  • Stale worktrees (no recent commits) → "Clean up?"
  • Workers behind main → "Rebase needed"
5. Quick Actions

Offer shortcuts:

  • /worker-cleanup <worktree> - Remove a specific worktree
  • /worker-pr <branch> - Create PR from worker branch
  • /worker-continue <worktree> "additional task" - Send more work

Notes

  • Only shows worktrees in the parent directory (../artemis-*)
  • Main repo worktree is always excluded from the list
  • Worktrees can be filtered by status if needed

Examples

Read the usage examples in the source repository.

View source ↗

Source history

Indexed on
2026-01-20
Index updated
2026-01-26
Branch
main

Index and sync dates describe this directory. View the source repository for code history.

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!