CLI Reference

capt-hook: Captain Hook — declarative hook framework for Claude Code lifecycle events.

Commands

run: Dispatch a hook event (reads JSON from stdin, writes JSON to stdout)
test: Run inline tests from the project’s own hooks in .claude/hooks (or –hooks).
hooks: List all discovered hooks without running their inline tests.
init: Scaffold the hooks directory, install bundled skills, wire settings, and enable the session reviewer.
logs: View a recent captain-hook session log.
status: Show the corrections the session reviewer is tracking and the hook PRs they would open.
heartbeats: Show per-event dispatch heartbeats for a session — an absent event is a wiring gap, not a quiet session.
mcp: Serve the capt-hook MCP server over stdio, exposing the register_transcript tool.

Manage the bundled Claude Code skills.

skills: Manage the bundled Claude Code skills.
install: Register the captain-hook plugin in .claude/settings.json (skills load from the plugin, not copied files).

Inspect capt-hook packs — the wheel builtins and the packs enabled Claude plugins ship.

pack: Inspect capt-hook packs — the wheel builtins and the packs enabled Claude plugins ship.
test: Validate and test a plugin’s capt-hook pack from its working tree.
list: List the active wheel builtins and the pack each enabled Claude plugin ships (read-only).

transcripts: Register external transcripts (codex rollouts, teammate runs) into a session’s deep view.
register: Register one external transcript against a session — exactly one of –thread-id or –path.

Mine ended sessions for durable corrections and draft hook PRs.

review: Mine ended sessions for durable corrections and draft hook PRs.
run: SessionEnd hook entry: guard and detach the reviewer (always exits 0).
sweep: Stop hook entry: guard and detach a throttled repo-wide sweep (always exits 0).
enable: Watch the current repo and register the captain-hook plugin.
disable: Stop watching the current repo (its candidates stay recorded).
scan: Scan explicit transcripts for corrections, incrementally.
triage: Judge stored corrections lacking a verdict (manual/backfill).
status: Show the tracked corrections, their progress toward a PR, and open PR status.
list: List the repo’s PR candidates.
show: Show one candidate’s row, its threshold status, and the shared ledger’s faulted edits.
threshold-check: Report which candidates cross their PR thresholds.
slots: Show the available open-PR slots for a repo.
update: Move a candidate to a new status.
snapshot: Write ~/.capt-hook/status.json for the desktop widget.
sync-prs: Fold open PR states back into candidate statuses.

Manage the Captain Hook desktop notification helper.

helper: Manage the Captain Hook desktop notification helper.
install: Install or upgrade the signed helper via Homebrew, then launch it in the background.
status: Ping the running helper and print its reported version.
notify: Send a test notification through the helper, launching it if needed.