capt-hook

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

capt-hook [OPTIONS] COMMAND [ARGS]...

Full --help output

Usage: capt-hook [OPTIONS] COMMAND [ARGS]...

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

Options:
  --hooks TEXT  Path to hooks package directory (default:
                $CLAUDE_PROJECT_DIR/.claude/hooks)
  --root TEXT   Project root for gitignore and session resolution
  --help        Show this message and exit.

Commands:
  heartbeats   Show per-event dispatch heartbeats for a session — an...
  helper       Manage the Captain Hook desktop notification helper.
  hooks        List all discovered hooks without running their inline tests.
  init         Scaffold the hooks directory, install bundled skills, wire...
  logs         View a recent captain-hook session log.
  mcp          Serve the capt-hook MCP server over stdio, exposing the...
  pack         Inspect capt-hook packs — the wheel builtins and the packs...
  review       Mine ended sessions for durable corrections and draft hook...
  run          Dispatch a hook event (reads JSON from stdin, writes JSON to
               stdout)
  skills       Manage the bundled Claude Code skills.
  status       Show the corrections the session reviewer is tracking and...
  test         Run inline tests from the project's own hooks in...
  transcripts  Register external transcripts (codex rollouts, teammate...

Options

--hooks: TEXT: Path to hooks package directory (default: $CLAUDE_PROJECT_DIR/.claude/hooks)
--root: TEXT: Project root for gitignore and session resolution

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.
skills: Manage the bundled Claude Code skills.
pack: Inspect capt-hook packs — the wheel builtins and the packs enabled Claude plugins ship.
transcripts: Register external transcripts (codex rollouts, teammate runs) into a session’s deep view.
mcp: Serve the capt-hook MCP server over stdio, exposing the register_transcript tool.
review: Mine ended sessions for durable corrections and draft hook PRs.
helper: Manage the Captain Hook desktop notification helper.