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

EventWhen it runs
session_startNOVA starts a session.
pre_tool_useBefore NOVA takes an action.
post_tool_useAfter NOVA takes an action.
turn_endA task finishes.
session_endThe 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.

Join Discord

Need help?

Open an issue on GitHub or email support@bridgeye.com.

Get help
Bridgeye • Autonomous Software Engineering.