Back
Advanced // Hooks
Hooks
Docs › Advanced › Hooks
Hooks
Hooks run your own commands when things happen in NOVA. For example, you can send a notification when a task ends, or block an action your team doesn't allow.
Events
| Event | When it runs |
|---|---|
| session_start | NOVA starts a session. |
| pre_tool_use | Before NOVA takes an action. |
| post_tool_use | After NOVA takes an action. |
| turn_end | A task finishes. |
| session_end | The session ends. |
Add a hook
Add hooks in Settings:
.nova/settings.json
{
"hooks": {
"turn_end": ["./scripts/notify.sh"]
}
}What your hook receives
Each hook gets a short JSON description of the event on its standard input. To see exactly what's sent:
bash
nova config hooks-doc
Block an action
If a pre_tool_use hook exits with an error, NOVA doesn't take that action, and is told why.
Note: Hooks set in a project's shared settings only run after you trust the project.
Join our Discord
Chat with our engineers and become part of the active NOVA developer community.
Need help?
Open an issue on GitHub or email support@bridgeye.com.