# capt-hook Captain Hook -- declarative hook framework for Claude Code lifecycle events. ``` bash 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)](../../reference/cli/run.md) `test` [Run inline tests from the project's own hooks in .claude/hooks (or -hooks).](../../reference/cli/test.md) `hooks` [List all discovered hooks without running their inline tests.](../../reference/cli/hooks.md) `init` [Scaffold the hooks directory, install bundled skills, wire settings, and enable the session reviewer.](../../reference/cli/init.md) `logs` [View a recent captain-hook session log.](../../reference/cli/logs.md) `status` [Show the corrections the session reviewer is tracking and the hook PRs they would open.](../../reference/cli/status.md) `heartbeats` [Show per-event dispatch heartbeats for a session -- an absent event is a wiring gap, not a quiet session.](../../reference/cli/heartbeats.md) `skills` [Manage the bundled Claude Code skills.](../../reference/cli/skills.md) `pack` [Inspect capt-hook packs -- the wheel builtins and the packs enabled Claude plugins ship.](../../reference/cli/pack.md) `transcripts` [Register external transcripts (codex rollouts, teammate runs) into a session's deep view.](../../reference/cli/transcripts.md) `mcp` [Serve the capt-hook MCP server over stdio, exposing the register_transcript tool.](../../reference/cli/mcp.md) `review` [Mine ended sessions for durable corrections and draft hook PRs.](../../reference/cli/review.md) `helper` [Manage the Captain Hook desktop notification helper.](../../reference/cli/helper.md)