# CLI Reference

[capt-hook](../../reference/cli/capt_hook.md)  
Captain Hook -- declarative hook framework for Claude Code lifecycle events.


# Commands

[run](../../reference/cli/run.md)  
Dispatch a hook event (reads JSON from stdin, writes JSON to stdout)

[test](../../reference/cli/test.md)  
Run inline tests from the project's own hooks in .claude/hooks (or -hooks).

[hooks](../../reference/cli/hooks.md)  
List all discovered hooks without running their inline tests.

[init](../../reference/cli/init.md)  
Scaffold the hooks directory, install bundled skills, wire settings, and enable the session reviewer.

[logs](../../reference/cli/logs.md)  
View a recent captain-hook session log.

[status](../../reference/cli/status.md)  
Show the corrections the session reviewer is tracking and the hook PRs they would open.

[heartbeats](../../reference/cli/heartbeats.md)  
Show per-event dispatch heartbeats for a session -- an absent event is a wiring gap, not a quiet session.

[mcp](../../reference/cli/mcp.md)  
Serve the capt-hook MCP server over stdio, exposing the register_transcript tool.


# skills


Manage the bundled Claude Code skills.


[skills](../../reference/cli/skills.md)  
Manage the bundled Claude Code skills.

[install](../../reference/cli/skills/install.md)  
Register the captain-hook plugin in .claude/settings.json (skills load from the plugin, not copied files).


# pack


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


[pack](../../reference/cli/pack.md)  
Inspect capt-hook packs -- the wheel builtins and the packs enabled Claude plugins ship.

[test](../../reference/cli/pack/test.md)  
Validate and test a plugin's capt-hook pack from its working tree.

[list](../../reference/cli/pack/list.md)  
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.


[transcripts](../../reference/cli/transcripts.md)  
Register external transcripts (codex rollouts, teammate runs) into a session's deep view.

[register](../../reference/cli/transcripts/register.md)  
Register one external transcript against a session -- exactly one of -thread-id or -path.


# review


Mine ended sessions for durable corrections and draft hook PRs.


[review](../../reference/cli/review.md)  
Mine ended sessions for durable corrections and draft hook PRs.

[run](../../reference/cli/review/run.md)  
SessionEnd hook entry: guard and detach the reviewer (always exits 0).

[sweep](../../reference/cli/review/sweep.md)  
Stop hook entry: guard and detach a throttled repo-wide sweep (always exits 0).

[enable](../../reference/cli/review/enable.md)  
Watch the current repo and register the captain-hook plugin.

[disable](../../reference/cli/review/disable.md)  
Stop watching the current repo (its candidates stay recorded).

[scan](../../reference/cli/review/scan.md)  
Scan explicit transcripts for corrections, incrementally.

[triage](../../reference/cli/review/triage.md)  
Judge stored corrections lacking a verdict (manual/backfill).

[status](../../reference/cli/review/status.md)  
Show the tracked corrections, their progress toward a PR, and open PR status.

[list](../../reference/cli/review/list.md)  
List the repo's PR candidates.

[show](../../reference/cli/review/show.md)  
Show one candidate's row, its threshold status, and the shared ledger's faulted edits.

[threshold-check](../../reference/cli/review/threshold_check.md)  
Report which candidates cross their PR thresholds.

[slots](../../reference/cli/review/slots.md)  
Show the available open-PR slots for a repo.

[update](../../reference/cli/review/update.md)  
Move a candidate to a new status.

[snapshot](../../reference/cli/review/snapshot.md)  
Write ~/.capt-hook/status.json for the desktop widget.

[sync-prs](../../reference/cli/review/sync_prs.md)  
Fold open PR states back into candidate statuses.


# helper


Manage the Captain Hook desktop notification helper.


[helper](../../reference/cli/helper.md)  
Manage the Captain Hook desktop notification helper.

[install](../../reference/cli/helper/install.md)  
Install or upgrade the signed helper via Homebrew, then launch it in the background.

[status](../../reference/cli/helper/status.md)  
Ping the running helper and print its reported version.

[notify](../../reference/cli/helper/notify.md)  
Send a test notification through the helper, launching it if needed.