cursor-hooks

Hooks are file-based, not programmatic. The SDK does not expose JS callbacks for the agent loop — use .cursor/hooks.json and rely on local.settingSources to load them.

When to use

• Lint / type-check gates before agent commits
• Audit logging or compliance commands after each turn
• Fail-fast policies that must run regardless of prompt

Concepts

• [[references/file-format]] — .cursor/hooks.json shape
• [[references/loading]] — settingSources and project vs user vs team scope
• [[references/programmatic-alternatives]] — what to use when you need JS callbacks (onDelta, onStep)

Cross-links