Guide
Deep dives into every part of the framework.
Hooks & Events — Registration patterns and the 9 event types
Conditions — Filter when hooks fire with typed condition objects
Primitives — One-line hooks: nudge, gate, lint, block_command
Transcript & Signals — Query conversation history and score patterns
LLM Hooks — Gate or nudge with LLM-powered evaluation
Workflows — Enforce multi-step checklists before the agent can stop
State & Sessions — Persist data across hook invocations
Testing — Inline tests, mock events, and dispatch testing
Configuration — HooksSettings knobs, env prefix, state and log directories
Patterns — Real-world hooks distilled from a production hooks directory
Troubleshooting — Common errors and diagnostic commands