[GH-ISSUE #61] Update Cursor IDE setup readme now that Cursor supports hooks #37

Closed
opened 2026-03-03 18:50:11 +03:00 by kerem · 1 comment
Owner

Originally created by @sulsDotK on GitHub (Jan 27, 2026).
Original GitHub issue: https://github.com/OthmanAdi/planning-with-files/issues/61

https://cursor.com/docs/agent/hooks

Originally created by @sulsDotK on GitHub (Jan 27, 2026). Original GitHub issue: https://github.com/OthmanAdi/planning-with-files/issues/61 https://cursor.com/docs/agent/hooks
kerem closed this issue 2026-03-03 18:50:11 +03:00
Author
Owner

@OthmanAdi commented on GitHub (Feb 4, 2026):

Fixed in 0b033eb — Cursor now has full hook support!

What was added:

.cursor/hooks.json — Hook configuration with 3 hooks:

  • preToolUse — Re-reads task_plan.md before Write/Edit/Shell/Read operations to keep goals in context
  • postToolUse — Reminds to update task_plan.md after file modifications
  • stop — Checks if all phases are complete. If not, uses Cursor's followup_message to auto-continue the agent (capped at 3 retries)

Hook scripts (bash + PowerShell):

  • .cursor/hooks/pre-tool-use.sh / .ps1
  • .cursor/hooks/post-tool-use.sh / .ps1
  • .cursor/hooks/stop.sh / .ps1

.cursor/hooks.windows.json — Alternative config for native PowerShell (no Git Bash needed)

Updated docs/cursor.md — Completely rewritten. Removed the old "hooks don't work" limitation section and documented the full hook setup.

The stop hook is actually more powerful in Cursor than in Claude Code — Cursor's followup_message auto-prompts the agent to keep working, whereas Claude Code's stop hook can only report status.

Thanks @sulsDotK for flagging this — great catch on the new Cursor hooks support!

<!-- gh-comment-id:3849734173 --> @OthmanAdi commented on GitHub (Feb 4, 2026): Fixed in 0b033eb — Cursor now has full hook support! ### What was added: **`.cursor/hooks.json`** — Hook configuration with 3 hooks: - **`preToolUse`** — Re-reads `task_plan.md` before Write/Edit/Shell/Read operations to keep goals in context - **`postToolUse`** — Reminds to update `task_plan.md` after file modifications - **`stop`** — Checks if all phases are complete. If not, uses Cursor's `followup_message` to auto-continue the agent (capped at 3 retries) **Hook scripts** (bash + PowerShell): - `.cursor/hooks/pre-tool-use.sh` / `.ps1` - `.cursor/hooks/post-tool-use.sh` / `.ps1` - `.cursor/hooks/stop.sh` / `.ps1` **`.cursor/hooks.windows.json`** — Alternative config for native PowerShell (no Git Bash needed) **Updated `docs/cursor.md`** — Completely rewritten. Removed the old "hooks don't work" limitation section and documented the full hook setup. The stop hook is actually more powerful in Cursor than in Claude Code — Cursor's `followup_message` auto-prompts the agent to keep working, whereas Claude Code's stop hook can only report status. Thanks @sulsDotK for flagging this — great catch on the new Cursor hooks support!
Sign in to join this conversation.
No labels
bug
pull-request
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/planning-with-files#37
No description provided.