> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hooks

> Measure hook activity, triggers, and latency separately from policy outcomes.

Hooks shows when agent lifecycle hooks run and how long they take. Policy decisions are a separate view.

<Tabs>
  <Tab title="Dashboard">
    1. Go to **Observe → Hooks**.
    2. Filter by environment, hook name, trigger event, agent, or session ID.
    3. Review hook latency and distribution.
    4. Select a chart point or hook segment to open the underlying events.

           <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/hooks.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=08837c16615a3a573cdcbcfd806a364a" alt="The Hooks page showing latency grouped by hook name and trigger event." width="3200" height="2000" data-path="images/dashboard/hooks.png" />
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    fp list hooks
    fp events --event-type hook_triggered,hook_completed --env production --since 24h
    fp events --search "PreToolUse" --since 24h
    ```
  </Tab>
</Tabs>