Guide

Deep dives into every part of the framework.

• Hooks & Events — Registration patterns and the 9 event types

  Hooks & Events

• Conditions — Filter when hooks fire with typed condition objects

  Conditions

• Primitives — One-line hooks: nudge, gate, lint, block_command

  Primitives

• Transcript & Signals — Query conversation history and score patterns

  Transcript & Signals

• LLM Hooks — Gate or nudge with LLM-powered evaluation

  LLM Hooks

• Workflows — Enforce multi-step checklists before the agent can stop

  Workflows

• State & Sessions — Persist data across hook invocations

  State & Sessions

• Testing — Inline tests, mock events, and dispatch testing

  Testing

• Configuration — HooksSettings knobs, env prefix, state and log directories

  Configuration

• Patterns — Real-world hooks distilled from a production hooks directory

  Patterns

• Troubleshooting — Common errors and diagnostic commands

  Troubleshooting