How do I monitor Cursor agents?

Install ClawMetry (pip install clawmetry). The daemon auto-detects Cursor's state.vscdb SQLite database and the ~/.cursor agent-chat JSONL files, and renders every session, tool call, model, and token in one dashboard at http://localhost:8900. No IDE extension, no wrapper.

Which Cursor data does ClawMetry read?

The agent-chat transcripts under ~/.cursor (JSONL, one file per chat, updated live during the session) and Cursor's own state.vscdb SQLite database for workspace metadata. Both are opened in read-only mode. Cursor stays untouched.

Can I see when Cursor switches models mid-session?

Yes. Every turn is labelled with the model id. When a chat starts on Sonnet and switches to Opus for a hard turn, ClawMetry shows the switch and the cost delta. Roll-ups on the Cost tab show per-model spend per session.

Does ClawMetry work with Cursor's Composer, Chat, and Agent modes?

Yes. All three write to the same agent-chat JSONL layout, so ClawMetry picks them up identically. Composer runs (multi-file edits) get their tool-call sequence and per-turn tokens surfaced the same way as a normal chat.

How much does ClawMetry cost for Cursor?

Free forever on your own machine. ClawMetry Cloud starts at $9 per node per month (Starter) or $19 per node per month (Pro, which adds policy gates and per-run waste flags). Cursor is one of 17 paid runtimes on the Cloud tier.

Observability and cost tracking for Cursor agents

See every Cursor agent chat, tool call, and token as it happens. ClawMetry reads Cursor's agent transcripts and the local state.vscdb and renders sessions, tokens, cost, and model routing in one dashboard. No IDE extension.

Supported runtime Reads SQLite state DB plus JSONL agent transcripts Read-only Free trial

What ClawMetry sees on Cursor

ClawMetry's Cursor adapter opens the store Cursor already writes (~/Library/Application Support/Cursor/User/globalStorage/state.vscdb (Mac), ~/AppData/Roaming/Cursor/User/globalStorage/state.vscdb (Windows), ~/.config/Cursor/User/globalStorage/state.vscdb (Linux), plus ~/.cursor agent-chat JSONL files) in read-only mode and surfaces:

Sessions: started at, last activity, model, message count, per-session token totals.
Live activity: every tool call as it lands, with args and result. Turn-level tokens split.
Per-turn tokens: The token counts Cursor writes for each agent turn, normalised to input/output/cache-read/cache-write.
Cost per session, per model, per hour: cache-aware where the model supports caching. Compare Cursor spend against the other 18 runtimes ClawMetry observes.
Per-turn model routing (Cursor lets the user or the agent pick per turn between Claude Sonnet, GPT-4o, and others): the Cursor-specific signal ClawMetry surfaces that generic dashboards do not.
Approval + kill switch: watch for token-maxing signals (message repeat, no-progress heuristic, cost-per-hour threshold), pause or kill the session before the next call.

Source: the adapter is at clawmetry_pro/adapters/cursor.py. Every parse rule and every SQL SELECT is in that file.

Enable it in about two minutes

1. Install ClawMetry

Pick the line that matches your OS. Windows users: paste the install.cmd line, not the shell one.

# macOS or Linux
curl -fsSL https://clawmetry.com/install.sh | bash

# Windows (cmd.exe or PowerShell)
curl -fsSL https://clawmetry.com/install.cmd -o install.cmd && install.cmd

2. Run the daemon

clawmetry

The daemon auto-detects Cursor's local store and starts reading immediately. No env var, no config, no runtime restart.

3. Open the dashboard

Open http://localhost:8900. Switch the runtime chip to Cursor.

Start the free trial →

The one thing this catches that Cursor alone does not

Left alone, Cursor's failure mode is an agent chat that switches to Opus for one turn and stays there for the rest of the session. ClawMetry watches for it: cost per hour on the Cursor runtime, message-repeat detection, and per-session token-growth curves. Set a threshold, and the approval queue pauses before the next call. Kill switch (Pro) stops it.

All 19 runtimes ClawMetry observes

Cursor is one of 19. Free on every plan: OpenClaw, NVIDIA NemoClaw. Paid on Cloud Pro or Self-Hosted Pro: the rest.

OpenClaw NVIDIA NemoClaw NanoClaw PicoClaw Claude Code Codex Cursor (this page) Aider Goose opencode Qwen Code Hermes Pi Deep Agents n8n Antigravity GitHub Copilot Grok QM