Hooks
Automate actions at every AI step.
Hooks run a shell command or send an HTTP request at key moments — before the AI acts, after a response, when a session starts. Set one up in 3 minutes.
~3 min·Beginner·11 steps
~/projects/centaurus
centaurus — type /help for commands
CWD: ~/projects/centaurus·Model: GPT-OSS 120BMode: Auto [Agent]
> Ask anything ...
Step 01/11Start at the main chat screen
Where do the hooks live?
Hooks saved to your global profile land in ~/.centaurus/hooks.json. Save to Project to commit hooks with your repo in .centaurus/hooks.json.
Every event has a payload
Your hook command receives context about what happened as JSON — which tool ran, what arguments were used, and whether it succeeded. See the full reference in the docs.
Want more walk-throughs?
Workflows and Skills tutorials are in the pipeline.