Hooks
What governor runs automatically, and when. A hook is a command Claude Code fires at a fixed moment, without you asking for it.
> /plugin marketplace add 0xhimanshu/governor > /plugin install governor@governor
Ships with governor. Installing the plugin gets these hooks.
What fires, and when
SessionStart
Fires once when a session begins, and again after a context compaction. It is where a plugin sets up its environment, or restores state the compaction dropped.
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/governor.py" hook session-start
UserPromptSubmit
Fires before Claude sees each prompt you send. A plugin can use it to inject context, so the same instruction reaches the model every turn instead of only at session start.
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/governor.py" hook prompt
PostToolUse
- Matches
*python3 "${CLAUDE_PLUGIN_ROOT}/scripts/governor.py" hook post-tool-use
PostToolUseFailure
- Matches
*python3 "${CLAUDE_PLUGIN_ROOT}/scripts/governor.py" hook post-tool-use-failure
PreCompact
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/governor.py" hook compact
Claude Code usage governor: compact professional output, context slimming, tool-output filtering, telemetry, and drift guardrails.
Repo: 0xhimanshu/governor