Never leave an agent
waiting in the woods.

Clarence keeps watch over every Cursor agent and subagent, then lets you know when something needs your attention.

Version 1.2.2 · macOS 14+ · Apple Silicon

The Clarence D’Cursor app showing attention, working, and recent agent activity
⌂Runs locally
◉Tracks every agent
◇Private by design
↗Gets you back to work

A clearer view of everything
Cursor is doing.

When several agents are working at once, Clarence turns their local events into one calm, persistent dashboard.

01
!

Catch what needs you

Questions and likely approvals rise to the top in a distinct attention state.

02
✦

Follow every helper

Parent agents and their subagents stay visible while they work, finish, or stop.

03
↗

Return in one click

Open the relevant workspace, copy the conversation ID, or use the transcript fallback.

04
⌂

Keep work on your Mac

Agent activity stays in a compact local log with sensitive details left out.

One glance tells the tale.

Clarence changes his portrait and Dock icon to match the most urgent thing happening.

Panicked Clarence
ErrorSomething went wrong
Curious Clarence
QuestionAn answer is needed
Clarence holding a checklist
ApprovalPermission may be needed
Clarence researching with books
SubagentA helper is researching
Clarence ready with tools
WorkingAn agent is on the job
Cheerful Clarence with a checkmark
CompleteThe work is finished
Clarence resting in a hammock
IdleAll is quiet
Clarence ready to work

Your work stays
on your Mac.

Clarence reads compact summaries from Cursor’s local hook events and stores them in a rotating local log.

  • Local storage with zero external telemetry
  • Common credential patterns are redacted
  • Tool output and full MCP parameters are omitted
  • Concurrent agents write safely with file locking

README & installation

Everything you need to install, use, and remove Clarence.

01 Requirements
  • Apple Silicon Mac
  • macOS 14 or later
  • Cursor with user hooks enabled

Clarence runs locally and works without Accessibility access. Event data and tool output stay off external services.

02 Install
  1. Download and unzip the package.
  2. Double-click Install.command.
  3. If macOS blocks it, right-click Install.command, choose Open, and confirm.
  4. Restart Cursor.
  5. Approve the Clarence user hooks once when Cursor prompts you.

The installer copies the app to ~/Applications, safely merges Clarence into your existing Cursor hooks, preserves unrelated hooks, and adds launch-at-login.

An existing hooks file is backed up as ~/.cursor/hooks.json.before-clarence.

03 Using Clarence
  • Orange cards require attention.
  • Running parent agents and subagents appear separately.
  • Completed work appears under Recent.
  • Click a card to focus its Cursor workspace and copy its conversation ID.
  • Right-click for workspace, transcript, and conversation-ID options.
  • Use the × on any card to dismiss it.
  • Resize the window freely and drag the parchment background to move it.
  • The Dock icon matches Clarence’s highest-priority status.

Cursor currently lacks a supported external deep link for local conversation IDs. Clarence opens the relevant workspace, copies the ID, and keeps the transcript available as a fallback.

04 Privacy & storage

Events stay on your Mac at:

~/Library/Application Support/Clarence D'Cursor/events.jsonl

The collector stores compact summaries, redacts common credential patterns, omits tool output and full MCP parameters, uses a file lock for concurrent agents, and rotates the log at 5 MB.

05 Elgato lights

Elgato actions require a separate setup. Clarence works alongside an existing ~/.cursor/hooks/elgato-alert.sh configuration.

06 Uninstall

Double-click Uninstall.command. It removes the app, login item, collector, and only Clarence-owned hook entries. Local event history is retained unless you delete it manually.

07 Source

The download includes the Swift package, checks, artwork, and build scripts used for this release.

Put Clarence on watch.

Download the local macOS companion and keep every Cursor agent within sight.

Download Clarence v1.2.214 MB · macOS 14+ · Apple Silicon