@brainervirus/workit-claude-code
Workit plugin for Claude Code: task context on session start and per turn,
branch policy on git shell commands, the before-write gate on edits and shell
writes, thirteen method skills (/workit:<name>),
and verifier, reviewer and implementer agents.
Install
Latest published (the repository root is the marketplace; its entry installs this npm package):
claude plugin marketplace add BrainerVirus/workit
claude plugin install workit@workit
Update with workit upgrade (native fallback: claude plugin marketplace update workit && claude plugin update workit@workit), then restart Claude Code; uninstall with workit uninstall.
Local pin to a checkout (hooks and bin/workit run the sources with Bun):
bun install
bun packages/workit-claude-code/scripts/build.ts --skills-only
claude --plugin-dir "$PWD/packages/workit-claude-code"
# or, for every session:
export CLAUDE_CODE_PLUGIN_DIRS="$HOME/path/to/workit/packages/workit-claude-code"
WORKIT_CLAUDE_RUNTIME=source|dist forces one runtime;
WORKIT_SHIM_TRACE=1 workit … prints which workit entry ran.
Layout
| Path | Purpose |
|---|---|
.claude-plugin/plugin.json | Manifest (version synced at release) |
hooks/hooks.json | SessionStart (startup/resume/clear/compact/fork), UserPromptSubmit, PreToolUse (Bash, PowerShell, Edit/Write/MultiEdit/NotebookEdit), SubagentStart |
bin/workit-hook.mjs | Hook launcher: source with Bun in a checkout, dist/workit-hook.js when installed; answers plain shell commands and edits in task-less checkouts with {} before loading the runtime; fails open ({} + one stderr line) when neither can run |
bin/workit | workit on the Bash tool's PATH (same source/dist switch) |
agents/ | verifier, reviewer (read-only), implementer (works in the lead's workit fanout worktree create worktree; no isolation) |
skills/ | Generated by scripts/build.ts from packages/workit-core/skills (not committed) |
Requires Node.js 24+ (installed plugin) or Bun (local pin).
Full guide: Claude Code.