Cursor

Cursor is included in the all-agent summary view, including --chart and --html. It is not a harness target.

agent-burn summary --value --cursor-plan ultra
agent-burn summary --chart --html
agent-burn summary --json --offline

--offline skips Cursor's dashboard RPC and reports no Cursor rows. Agent Burn does not read chat bodies from state.vscdb.

Data source

Agent Burn reads the signed-in Cursor session from the local state database, then loads day-by-model usage from Cursor's dashboard API.

Default state database:

Overrides:

• CURSOR_DATA_DIR — Cursor application-support directory, globalStorage directory, or a state.vscdb file
• CURSOR_ACCESS_TOKEN — session token, for tests or unusual installs

Usage rows come from GetAggregatedUsageEvents on api2.cursor.sh. Each row is a day × model aggregate (input, output, cache write, cache read, optional native cents). Without --since, Cursor uses the current billing cycle when the API reports it, otherwise the last 31 days.

Live --value --json account balances keep included allowance and promotional credits separate. The included pool can stay unused while credits burn first. activePercentUsed follows the burning balance so remaining quota keeps moving.

The macOS Cursor tab follows that same split. While promotional credits remain, it shows a Codex-style remaining meter and history chart against the credit grant and its expiration. After those credits are gone, it shows the daily spend chart with All models and Cursor models filters.

Plan overrides

Detected from cursorAuth/stripeMembershipType when present:

agent-burn summary --value --cursor-plan pro
agent-burn summary --value --cursor-plan pro+
agent-burn summary --value --cursor-plan ultra
agent-burn summary --value --cursor-plan 200