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

• local.settingSources → [[../cursor-sdk/references/local-options]]
• Stream-side observation → [[../cursor-runs/references/interaction-updates]]
• Sibling .cursor/ features → [[../cursor-rules/SKILL]] · [[../cursor-skills-system/SKILL]]