Development
Hook
Hooks
What ouroboros runs automatically, and when. A hook is a command Claude Code fires at a fixed moment, without you asking for it.
Install
> /plugin marketplace add Q00/ouroboros > /plugin install ouroboros@ouroboros
Ships with ouroboros. 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.
- Matches
*python3 "${CLAUDE_PLUGIN_ROOT}/scripts/session-start.py"
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.
- Matches
*python3 "${CLAUDE_PLUGIN_ROOT}/scripts/keyword-detector.py"
PostToolUse
- Matches
Write|Editpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/drift-monitor.py"