How do I use Ward with Cursor?
Updated
Run ward integrate cursor in your project. Ward writes .cursor/hooks.json and .cursor/hooks/ward.sh and checks the code Cursor writes.
What does the integration install?
| Cursor event | What happens |
|---|---|
preToolUse (Shell, Write, Delete) |
With the guard enabled, refuses protected changes |
postToolUse (Write, Delete) |
Runs the quality check. Findings go back as additional_context |
stop |
Runs the quality check and spec validation. Findings are sent once as the next prompt |
Cursor runs project hooks from the project root, in the editor and in cursor-agent.
Keep ward on your PATH.
What does the agent see when a check fails?
After an edit, findings go to the conversation as additional_context. When the agent stops, they are submitted once as the next prompt. If they remain, they are only reported.
How do I install and remove it?
ward integrate cursor
ward integrate cursor --removeGenerated files carry a Ward ownership marker. Ward refreshes only its own files and reports any file you wrote as a conflict.
Is it tested?
The generated files pass tests against the documented contract of cursor-agent 2026.10.14. A live run is not recorded yet. Ward is in alpha, so the CLI and the configuration may change before 1.0.
Where do I go next?
Ready to try it? Install Ward and run ward init in your project.