Atlas · agents
Hooks
Scripts the harness runs at set moments, such as before every tool call, that can block an action and say why.
See it working: Plate II
In plain words
A hook is a small program that runs automatically, for example right before the agent runs a shell command. It can stop the command.
How it works
A PreToolUse hook receives the details of the call before it runs. If it blocks the call, its message goes back to the model, which can then change course.
Going deeper
Hooks are configured in settings, so they apply to the project where the session starts. A session started in a parent folder does not load the project’s hooks. Agent Atlas learned this the hard way; see the journal.
Sources
- Hooks reference Anthropic
Before a tool call executes. Can block it
blocks the tool call, and shows Claude the reason.
Quotes were checked against the live pages on 2026-11-08.