caret

Quickstart

Get Caret running in three commands. Your first supervised agent session.

Prerequisites

  • Node.js 18 or later
  • One of: Claude Code, Cursor, Codex, or Aider installed
  • A project directory with a git repository

Install

Three commands. Under two minutes.

# 1. Initialize Caret in your project
npx caret init

# 2. Install supervisor hooks for your agent
caret supervisor install --agent claude-code

# 3. Start the background daemon
caret daemon start

That's it. Every agent session in this project is now supervised.

First supervised session

Open your agent and submit a prompt as usual. Caret runs silently in the background. Try a prompt that will trigger drift to see Caret in action: 

# In Claude Code, try:
"Fix the login form validation in src/app/login/page.tsx"

If the agent starts editing files outside src/app/login/, Caret will detect scope drift and send you an alert.

What you should see

🖼 Terminal screenshot — caret supervisor status output showing active hooks and daemon
Expected output after successful installation

Check supervisor status to confirm everything is working:

$ caret supervisor status

✓ Supervisor active
  Agent:    claude-code
  Hooks:    UserPromptSubmit, PreToolUse, PostToolUse
  Daemon:   running (pid 48291)
  Config:   caret.config.json (6 detectors enabled)

After a session completes, view the results:

$ caret sessions --limit 1

  ID          Intent                        Agent        Health  Drifts
  ses_a1b2c3  fix login form validation     claude-code  92      0

Next steps

Was this helpful?