Headroom Plugin Hooks
Lightweight startup hooks that ensure the Headroom runtime is available for Claude Code and GitHub Copilot CLI sessions.
Hooks
| Hook | Matcher | Command | Timeout |
|---|---|---|---|
| SessionStart | startup, resume | headroom init hook ensure |
15s |
| PreToolUse | Bash, PowerShell | headroom init hook ensure |
15s |
Behavior
The headroom init hook ensure command checks for a matching durable
headroom init deployment and starts it if needed. This ensures the Headroom
compression proxy is running before any API calls are made.
Requirements
headroom-aipackage installed (uv tool install "headroom-ai[all]"orpip install "headroom-ai[all]")- Headroom proxy initialized (
headroom init)