@brainervirus/workit-claude-code
v7.5.1
Published
Workit Claude Code plugin — session and per-turn task context, branch policy on git shell commands, workit method skills, and verifier/reviewer/implementer agents
Maintainers
Readme
@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, eleven 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
claude plugin marketplace update workit && claude plugin update workit@workit # updateLocal 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 (isolation: worktree) |
| skills/ | Generated by scripts/build.ts from packages/workit-core/skills (not committed) |
| evals/ | Opt-in claude plugin eval suite (nightly / eval label, not a PR gate) |
Requires Node.js 24+ (installed plugin) or Bun (local pin).
Full guide: Claude Code.
