Agent Atlas

Atlas · agents

Hooks

Scripts the harness runs at set moments, such as before every tool call, that can block an action and say why.

Established practiceDepth 2 of 4Reviewed 2026-11-08

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

  1. 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.