Answer: Define hooks in a `hooks.json` file; project-level hooks go in `/.cursor/hooks.json` and user-level hooks go in `~/.cursor/hooks.json`. Project hooks run from the project root, while user hooks run from `~/.cursor/`. Status: Confirmed Entry: tool/cursor/settings/configure-hooks-json Revision: 2 Digest: sha256:d654e0b8e779c275 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:10:50Z Last changed: 2026-11-18T12:32:14Z (Project path style: — → .cursor/hooks/script.sh) Last verified: 2026-11-20T12:38:10Z Next check: 2026-11-21T12:38:10Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of Project config path | /.cursor/hooks.json | [1] | 2026-11-20 User config path | ~/.cursor/hooks.json | [1] | 2026-11-20 Priority order | Enterprise → Team → Project → User | [1] | 2026-11-20 Project hook working directory | project root | [1] | 2026-11-20 User hook working directory | ~/.cursor/ | [1] | 2026-11-20 Project path style | .cursor/hooks/script.sh | [1] | 2026-11-20 Schema version | 1 | [1] | 2026-11-20 Sources: [1] Anysphere. "cursor.com/docs/hooks.md". https://cursor.com/docs/hooks.md Role: primary. Accessed: 2026-11-20T12:38:10Z Quote: "`/.cursor/hooks.json`" (Supports: Project config path) Quote: "`~/.cursor/hooks.json`" (Supports: User config path) Quote: "Priority order (highest to lowest): Enterprise → Team → Project → User" (Supports: Priority order) Quote: "**Project hooks** (`.cursor/hooks.json` in a repository): Run from the **project root**" (Supports: Project hook working directory) Quote: "**User hooks** (`~/.cursor/hooks.json`): Run from `~/.cursor/`" (Supports: User hook working directory) Quote: "For project hooks, use paths like `.cursor/hooks/script.sh` (relative to project root)" (Supports: Project path style) Quote: "Must be a positive integer (use `1`)." (Supports: Schema version) Snapshot SHA-256: 5af36d6a319bf8ecb6cd3be1e49690fa8fe2bf7f1b5accee2d8cc524f744fee5 (captured 2026-11-17T12:48:22Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-17T12:48:20Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:38:10Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:38:10Z Last attempt: 2026-11-20T12:38:10Z Notes and limitations: Extracted automatically from a single official source (section "Configuration"). Related: https://latestn.com/tool/cursor/settings/configure-mcp-json How do I configure an MCP server in Cursor using mcp.json? https://latestn.com/tool/cursor/settings/configure-rules How do I configure Bugbot rules for my repository? https://latestn.com/tool/cursor/settings/create-project-rule How do I create a project rule in Cursor? https://latestn.com/tool/cursor/settings/configure-agent-review How do I enable or configure Cursor Agent Review? https://latestn.com/tool/cursor/settings/configure-cloud-agents-options How do I configure options like repos and autoCreatePR for Cursor cloud agents? https://latestn.com/tool/cursor/settings/configure-default-model-slack How do I configure the default model for Cursor Slack agents? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-18T12:32:14Z | changed | Project path style: — → .cursor/hooks/script.sh | [1] 2026-11-18T12:32:14Z | changed | User hook working directory: — → ~/.cursor/ | [1] 2026-11-18T12:32:14Z | changed | Project hook working directory: — → project root | [1] 2026-11-18T12:32:14Z | changed | Project path example: .cursor/hooks/script.sh → — | [1] 2026-11-18T12:32:14Z | changed | User hooks working directory: ~/.cursor/ → — | [1] 2026-11-18T12:32:14Z | changed | Project hooks working directory: project root → — | [1] 2026-11-13T03:10:50Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/cursor/settings/configure-hooks-json/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/cursor/settings/configure-hooks-json POST: https://latestn.com/dispute/tool/cursor/settings/configure-hooks-json with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/cursor/settings/configure-hooks-json?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I configure Cursor hooks in hooks.json at the project or user level? Revision 2, last verified 2026-11-20T12:38:10Z. https://latestn.com/tool/cursor/settings/configure-hooks-json (accessed 2026-11-21T09:55:07Z). @misc{LatestN_tool_cursor_settings_configure_hooks_json_r2, title = {How do I configure Cursor hooks in hooks.json at the project or user level?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/cursor/settings/configure-hooks-json}}, note = {Revision 2; digest sha256:d654e0b8e779c275; last verified 2026-11-20T12:38:10Z; accessed 2026-11-21T09:55:07Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/cursor/settings/configure-hooks-json