seabbs Org Maintenance
Clean up dead worktrees and unstick PRs across repos in an org.
Run from ~/code/{org}/ or pass the org name as an argument.
Accounts
Read bot_account, owner_account from the org's CLAUDE.md ## Automation config table.
Helper script
A pre-built script at ~/.claude/scripts/org-maintenance.sh collects worktree and PR data in one pass.
Run it first to avoid spending tokens on individual git and gh calls.
~/.claude/scripts/org-maintenance.sh <org-name> > /tmp/org-maintenance.json
If the script is missing or not executable, flag this to the user and stop.
The script outputs a JSON object with:
worktrees: array of non-main worktrees per repo (path, branch, whether directory exists)open_prs: array of open PRs by the bot/owner accounts with CI status, review decision, merge info
Phase 1: Worktree Audit
From the script output, flag worktrees that:
- Point to missing directories (
exists: false) - Have branches merged or deleted on the remote
- Have no commits in 30+ days and no uncommitted changes
Present a summary table and prune with confirmation.
Phase 2: Stuck PR Audit
From the script output, identify PRs that are stuck:
- CI status (failing checks)
- Review status (changes requested, unreviewed)
- Time since last update
- Merge conflicts
What to fix
For bot/owner PRs (full access):
- Fix failing CI (linting errors, test failures, docs issues)
- Resolve merge conflicts
- Address review comments where the fix is mechanical
- Push fixes directly to the PR branch
For PRs on other people's repos:
- Open a new PR addressing linting, docs, or test coverage gaps only
- Make it clear in the PR description that suggestions are optional
- Do not touch architectural or behavioural changes
What NOT to fix
- Design decisions or API changes
- Anything requiring domain knowledge beyond the code itself
- PRs with ongoing discussion (don't interrupt)
Phase 3: Team mode
If more than 3 PRs need attention, spawn a team. Each teammate handles one PR fix. The lead tracks progress and reports results.
Phase 4: Summary
Report:
- Worktrees pruned (count by repo)
- PRs fixed (with links)
- PRs skipped (with reason)
Auto-Exit When Standalone
IMPORTANT: If this command is being run as a standalone request, automatically exit after completing all phases successfully.