Kevin Veen-Birkenbach
ebe7886654
kvb-git-branch-gc becomes kvb-git-branch-cleanup and kvb-git-orphans-find becomes kvb-git-worktree-orphans, which drops its own orphans.py for pkgmgr's output. New wrappers: kvb-git-gc, kvb-git-worktree-cleanup and kvb-git-worktree-up. kvb-cleanup, kvb-dream, AGENTS.md and README.md point at the new names. Merges only after the pkgmgr release that ships these commands. 🎯 Fix: 90 % 💥 Break: 3 % 💸 Cost: new ⏱️ Time: new 🛡️ Security: 100 % 🏆 Score: 87 🚦 Gate: cost new, time new: cleared by the operator's commit word for the Skills wrappers (2026-11-07) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> (cherry picked from commit 18dade9a48a84761bf0c3a9b35584367ae0cb0e4)
1.9 KiB
1.9 KiB
name, description
| name | description |
|---|---|
| kvb-git-worktree-cleanup | Remove merged or pushed clean worktrees. |
pkgmgr worktree cleanup removes a clean worktree whose commits are merged
or pushed: the pinned worktree-fini hook, its compose stack with volumes and
images, the checkout; the branch stays. This skill adds only the agent
discipline: run the steps of the kvb-git-branch-cleanup skill
(${CLAUDE_SKILL_DIR}/../kvb-git-branch-cleanup/SKILL.md, with its
apply.md and unmerged.md) with these changes.
Changes
- Claim:
work/worktree-cleanup-<repo>, orwork/worktree-cleanup-all. The apply takes stacks down with their volumes, so the chair's grant comes first. - Dry run:
pkgmgr worktree cleanup --json --sizes --min-age 24 --merged-into <line>, output to/tmp/worktree-cleanup-<N>.json. A candidate may beunmergedwithunpushed0: its worktree goes, its branch stays; its description says so. - Hooks:
hook:worktree-finiamong theactionsmeans the operator's pkgmgr config pins it (worktree_hooks, keyed<provider>/<account>/<repository>). Without it pkgmgr runs no fini hook, even where the worktree's Makefile defines aworktree-finitarget: name such a target in the item's note, since its teardown then does not run. Pinning is the operator's; never run the target in place of pkgmgr. - Apply:
pkgmgr worktree cleanup --apply --json --branch <name or path>, one--branchper picked item,| tee /tmp/worktree-cleanup-apply-<N>.json. From an agent sandbox it always goes to the operator: pkgmgr refuses there, andgit worktree removefails with EBUSY on the read-only.git/worktrees/<id>mount. Never remove a checkout or its metadata by hand. Adoneitem drops onlyworktree:<path>from the register. - Dirty or unpushed worktrees reach step 5; the
kvb-git-worktree-orphansskill finds the abandoned ones among them.