Cursor Installation

Overview

Caret integrates with Cursor via its rules system and an external hook handler. Supervision covers Cursor's Agent mode where it executes tool calls autonomously.

Prerequisites

• Cursor installed (v0.40+)
• Node.js 18+
• An Caret account (caret login)

Installation

# Initialize Caret
npx caret init

# Install for Cursor
caret supervisor install --agent cursor

# Start the daemon
caret daemon start

How it works

Cursor doesn't have the same hooks API as Claude Code. Caret integrates via:

1. Cursor Rules: Caret adds a rule that instructs the agent to report tool calls to the Caret daemon.
2. File supervisor: The Caret daemon tracks file changes in your project and correlates them with agent sessions.
3. Git diff capture: After each agent action, Caret captures the git diff to track what changed.

Verify installation

$ caret supervisor status

✓ Supervisor active
  Agent:    cursor
  Mode:     file-watcher + rules
  Daemon:   running (pid 48291)
  Config:   caret.config.json (6 detectors enabled)

Cursor Rules integration

Caret adds a .cursor/rules/caret.mdc file to your project. This rule is automatically loaded by Cursor and provides the agent with instructions for cooperating with the supervisor.

You don't need to modify this file. If you have existing Cursor rules, Caret's rule is added alongside them without conflicts.

Troubleshooting

• "Cursor not detecting rules" — Ensure .cursor/rules/ exists and Cursor is configured to read project rules.
• "Sessions not appearing" — The file watcher needs the daemon running. Check caret daemon status.
• "Drift detection seems delayed" — File-watcher mode has slightly higher latency than hook mode. This is expected for Cursor.