worktree-guard

A Claude Code mod in thieung/claude-mods

Guards a shared worktree: stops `git add -A` from staging files this session did not touch, previews destructive git commands, and points at the process holding a busy port.

review UI rewrite

worktree-guard reaches L2 (writes or runs) by its classified calls and passed claude plugin validate on Claude Code 2.1.302.

Events hooked: 5
API methods referenced: 13
Access from classified calls: L2, writes or runs: runs processes, draws
Unclassified calls: 2 ($.state.get, $.state.set), full access unknown
Static scan, not a runtime test

Install hint

/plugin install worktree-guard --marketplace thieung/claude-mods

From the repository's own marketplace. Confirm the plugin name in the repository's README before installing. Mods need Claude Code 2.1.287 or later.

Access

L2 Writes or runsother: $.state.get, other: $.state.set, runs processes, draws

Validation

Passed on Claude Code 2.1.302

View the source on GitHub Back to the list

What the scan recorded

Observed events: every tool call, Bash calls
Hooks: session.start, tool.call, tool.call {tool=Bash}, session.end, command.run {command=guard-files}, ui.render {component=Pane, requestId=worktree-guard}, ui.render {component=AbovePrompt}
API calls: $.command.register, $.process.run, $.session.cwd, $.session.id, $.state.get, $.state.set, $.ui.ask, $.ui.close, $.ui.log, $.ui.open, $.ui.panes, $.ui.resolve, $.ui.toast
Validation on 2.1.302: Passed
Scanned revision: bc038914b142
Marketplace passed: thieung-mods
UI rewrite review: UI hook source contains control-character strings. Review any values passed to next() as rewritten props.text; the scanner does not trace whether these strings reach that call. worktree-guard/hooks/lib/git-status.ts:9, worktree-guard/hooks/register.tsx:37, worktree-guard/hooks/register.tsx:185

These are the hooks and API calls reported by claude plugin validate. Access levels describe the widest reach of those calls and are not safety ratings. Validation is a static check, not a runtime test, and a passing result does not prove that a mod works or is safe. How the scan works.

Badge for your README

Authors can show the latest scan result in their README. Each badge links to this page.

[![reach](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/thieung--claude-mods--worktree-guard-reach.svg)](https://mods.aidojo.si/mods/thieung--claude-mods--worktree-guard/)
[![validates](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/thieung--claude-mods--worktree-guard-validates.svg)](https://mods.aidojo.si/mods/thieung--claude-mods--worktree-guard/)