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:
  generate-settings  Generate Claude Code settings JSON for...
  init               Scaffold the hooks directory, install bundled...
  logs               View a recent captain-hook session log.
  run                Dispatch a hook event (reads JSON from stdin, writes JSON
                     to stdout)
  skills             Manage the bundled Claude Code skills.
  test               Run inline tests from all registered hooks.

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)
generate-settings: Generate Claude Code settings JSON for .claude/settings.local.json.
test: Run inline tests from all registered hooks.
init: Scaffold the hooks directory, install bundled skills, and wire settings.
logs: View a recent captain-hook session log.
skills: Manage the bundled Claude Code skills.