在状态栏显示 Cursor 现行 token 计费用量的 Cursor IDE 扩展
Cursor 已改为按 token、双池计费（不再是旧的「fast-premium 请求次数 + 美元」）。本扩展读取 dashboard 接口，按账号类型切换展示：个人看双池百分比，团队 / 企业看套餐内花费。
状态栏常驻 个人：C xx% · O xx%。团队 / 企业：套餐内已用 vs 上限（接口美分，非本地估算） |
详情面板 点击状态栏：双环用量、模型用量占比、带费用的最近消耗、趋势图 |
|---|---|
账号自适应 类型来自接口（individual / team / enterprise），不从 token 猜测 |
用量提醒 两次轮询之间的变化超过阈值时弹窗，监控项与阈值可配 |
更多亮点：
- 自动刷新，默认 30 秒；窗口失焦时降低频率；状态栏、提醒、详情面板都不用时暂停；连续失败后指数退避
- 状态栏轮询只拉一页、最多 100 条事件；打开或刷新详情面板时翻页拉取账单周期历史，每次最多 30 页（3,000 条）
- 分页失败或达到上限时标记历史不完整；请求失败时显示警告，并保留同一账号、同一账单周期内已有的缓存数据
- 中 / 英界面，跟随编辑器语言
- macOS / Windows / Linux 通用 VSIX，首次确认后读本机 Cursor 会话（
state.vscdb） - UI 扩展（
extensionKind: ui）：SSH Remote、WSL、Dev Containers 下仍读本机登录 - 正数的单次费用，以及汇总金额（含真实的
$0.00），才显示$；不用官网单价估算账单 - 趋势图默认当前账单周期；From / To 可在周期内收窄
- 今日消费展示接口费用、Token、请求数和主要模型；事件费用加总为 0 时标注「接口未返回费用」
- Cursor Models 和 Other Models 各自在 50%、80%、100% 提醒；金额提醒仍在接口返回美元时按同样档位提醒。连接诊断展示认证来源、接口结果和轮询状态
从 Open VSX（Cursor 扩展市场）安装。搜 Cursor Token Usage，或：
cursor --install-extension akitogo.cursor-token-usage- 当前源码版本可按从源码构建生成
cursor-token-usage-1.1.5.vsix；若对应版本已发布，也可从 Releases 获取 - 拖进 Cursor，或
Cmd+Shift+P（Windows：Ctrl+Shift+P）→Extensions: Install from VSIX... - 执行
Developer: Reload Window
装好后状态栏应出现用量。读不到会话时显示 Set Token，见下方认证。
首次启动会询问是否允许读取本机 Cursor 会话。允许后从 state.vscdb 读取 cursorAuth/accessToken 与用户 id，拼成 WorkosCursorSessionToken Cookie，只发给 cursor.com。也可以拒绝，改为手动设置 Token。
| 系统 | 会话文件 |
|---|---|
| macOS | ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb |
| Windows | %APPDATA%\Cursor\User\globalStorage\state.vscdb |
| Linux | ~/.config/Cursor/User/globalStorage/state.vscdb |
自动读取直接解析 state.vscdb，包括尚未 checkpoint 的 WAL 页，不需要 Python 或 sqlite3 命令。读不到本机会话时，用 Set Session Token。
自动检测失败时：
- 命令面板 → Cursor Token Usage: Set Session Token
- 粘贴
WorkosCursorSessionToken（格式：userId%3A%3AaccessToken） - Token 写入 VS Code SecretStorage，不进
settings.json
浏览器取 Cookie：打开 cursor.com → 开发者工具 → Application → Cookies → 复制 WorkosCursorSessionToken。
远程工作区： 本扩展在本机 Cursor 进程跑，不要装到 SSH / WSL / 容器远端。
状态栏悬停会显示进度条（模型池或套餐内金额）、简短的按模型表、重置倒计时，以及打开详情和刷新的链接。区块之间用分割线隔开。
最近消耗表展示最近若干条（displayCount，默认 5 条）：时间、模型、类型、用量、费用。分类默认是全部。选模型或自动化（例如 Grok BOT）时，会先分类再取最近几条，自动化记录不会把后面的模型用量挤出列表。导出 CSV 写出已获取的全部事件，不只是表上可见的几条，并以引号前缀挡住会被表格软件当成公式的单元格。事件接口返回大于 0 的美分时显示美元。金额缺失或明确为 0 时，显示「接口未返回费用」。侧边栏展开同一条记录也能看到这笔费用。套餐内已用、On-Demand 和金额提醒来自汇总接口，汇总为 0 时仍显示 $0.00。
模型用量是占比进度条。指标可在 Token、请求数、费用之间切换，进度条按当前指标排序和占比。悬停跟着鼠标走：Token 显示输入 / 输出 / 缓存，请求数显示套餐内和 On-Demand，费用显示接口金额。点击一行可筛选趋势。页面右上角是这个周期的请求数、接口费用和 Token 合计。状态栏悬浮窗里的短表标题仍是「按模型」。
进度条：绿 < 40%、黄 < 80%、橙 ≥ 80%、红 ≥ 100%。用量 ≥ 80% 状态栏警告底色，≥ 100% 错误底色。
面板工具栏保留等高的刷新与设置按钮。设置菜单用细线分隔常规设置、提醒与诊断，右侧细箭头提示展开状态，配色跟随 Cursor 主题；支持 Tab 切换，Esc 返回设置按钮，点击外部或执行操作后收起。
刷新时显示忙碌状态并合并重复请求；刷新期间打开详情，仍按详情模式分页补拉历史。工具栏显示数据获取时间；通过面板刷新按钮操作后恢复滚动位置和按钮焦点，并保留有效的筛选条件。
首屏仅保留请求数、已知费用、本周期 Token，统计口径收进悬停提示，不受趋势筛选影响；事件费用不等于最终账单。额度数据缺失时使用中性的 (?)，不会按零用量显示“额度宽裕”。历史不完整时，趋势中的无记录日期为未知值，曲线在缺口处断开；已知日期的费用浮层仍会标明缺价数量。曲线使用保形插值，不产生额外峰谷或负消费。
改变筛选后显示清除筛选，可恢复本周期日期、全部额度池和模型，并保留指标选择。模型名称是可聚焦按钮，可用 Tab / Enter 操作，模型明细也支持焦点查看与 Esc 关闭。查看每日数据采用灰色文字、细箭头和分隔线作为折叠入口，展开后文字加深、箭头转向；提供与趋势相同筛选范围的数据表，最多显示 400 天，超过时提示缩小日期范围。趋势标题保留「所选范围内的每日用量」，模型区保留点击筛选的短提示，其余统计口径通过悬停查看。窄分栏下模型名称单独一行，表格可横向滚动；系统启用减少动态效果时关闭过渡与平滑滚动。
今日消费和额度提醒默认收起，把更多空间留给使用趋势。点击标题即可展开或收起，也可用 Tab 聚焦后按 Enter／空格操作。收起后仍展示关键金额、Token、额度进度及数据不完整／提醒暂停提示。两个区块各自保存本机展开状态，刷新、关闭重开面板及重载 Cursor 后都会恢复。
面板最大可用宽度为 1,000 px；趋势图随面板宽度重绘并调整日期标签密度。收起今日或额度提醒，或调整面板大小时，会保留日期、模型、用量池和指标。费用指标仅在至少一条事件返回大于 0 的美分时绘制。
趋势图是输入、输出、缓存堆叠柱，上面叠一条合计曲线。用量可选全部、Cursor Models（Grok、Composer、Auto）或 Other Models（Claude、GPT、Gemini 这类第三方模型），指标可选 Token、请求数或费用。日期轴默认铺开当前账单周期。使用趋势、模型用量和最近消耗固定展开；用量、指标、分类和导出留在卡片标题上。套餐卡片以 C / O 单行展示已用百分比，全称与内外环关系可悬停查看；数字下方以「重置倒计时：9天11小时」的格式显示实际剩余时间。页头展示套餐和账单周期日期。外环是 Other Models，内环是 Cursor Models。环心是颜文字，跟着两份额度里较高的一边变化：40% 以下 (^_^)，80% 以下 (・_・)，100% 以下 (>_<)，超过 100% 是 (×_×)。鼠标停在表情上会看到对应说明。企业账号如果接口只返回套餐内已用美元和上限，环是单环，环心仍用这套颜文字，额度按已用金额相对上限的百分比在 50%、80%、100% 提醒，状态栏显示已用金额和上限。接口如果同时返回两份额度百分比，则和个人版一样是双环。
| 配置项 | 默认 | 说明 |
|---|---|---|
cursorTokenUsage.budgetAmount |
0 | 金额提醒（美元）；0 只关闭这笔提醒。两份额度的 50%、80%、100% 提醒不受此项控制 |
cursorTokenUsage.budgetMetric |
onDemand |
金额提醒口径：onDemand 或 included；应用全局配置 |
cursorTokenUsage.displayCount |
5 | 详情面板最近用量条数（不影响趋势图拉取范围） |
cursorTokenUsage.pollingInterval |
30 | 轮询间隔（秒，5–300） |
cursorTokenUsage.showStatusBar |
true | 是否显示状态栏 |
cursorTokenUsage.statusBarAlignment |
right |
状态栏位置：left / right |
cursorTokenUsage.alertEnabled |
true | 用量变化、额度档位与金额提醒的总开关 |
cursorTokenUsage.alertItems |
newSession overallSpending cursorModels otherModels totalTokens |
监控项 |
cursorTokenUsage.alertThreshold.newSession |
2 | 单次轮询新增调用数 |
cursorTokenUsage.alertThreshold.overallSpending |
1 | 套餐内花费变化（$） |
cursorTokenUsage.alertThreshold.cursorModels |
10 | Cursor Models 池变化（百分点） |
cursorTokenUsage.alertThreshold.otherModels |
10 | Other Models 池变化（百分点） |
cursorTokenUsage.alertThreshold.onDemandSpending |
1 | On-Demand 花费变化（$） |
cursorTokenUsage.alertThreshold.totalTokens |
100000 | Token 总量变化 |
| 命令 | 作用 |
|---|---|
| Show Token Usage Details | 打开详情面板（等同点击状态栏） |
| Refresh Token Usage | 获取用量；若已有轮询则等待其结束，面板打开时同时拉取历史 |
| Set Session Token | 粘贴 / 清除 Session Token |
| Set Polling Interval | 5–300 秒 |
| Set Status Bar Side | 左 / 右 |
| Configure Usage Alerts | 开关、监控项、阈值 |
| Configure Amount Alert | 选择金额口径，设置一笔美元提醒 |
| Show Connection Diagnostics | 打开连接及轮询状态的只读报告 |
- 命令面板 → Configure Usage Alerts，或详情面板 → 设置 → 配置用量提醒
- 按需选择暂停所有提醒／恢复所有提醒、监控项和阈值
- 可监控：新增调用、套餐内花费、Cursor Models %、Other Models %、On-Demand 花费、Token 总量
- 阈值
0表示任何正向增长都提醒；输入框按监控项标明请求数、USD、百分点或 Token，拒绝空值、非有限数、负数及大于1e12的值
阈值看的是同一账号、同一账单周期内连续两次成功轮询之间的正向增长，不是累计或绝对上限。例如
onDemandSpending = 1.0：这两次轮询之间 On-Demand 增加 $1.00 或以上才触发。
新请求提醒无需打开详情面板，会统计本次拉取页面中新观察到的请求；补拉旧历史不会触发提醒。后台每次最多获取 100 条事件，高频使用或较长轮询间隔可能漏掉页面之外的请求。打开详情会拉取更多历史，但不会对较旧请求补发提醒。
账号或账单周期变化时重置提醒基线。请求失败后的首次成功轮询只建立新基线；事件或模型汇总接口失败时，也会暂停相应提醒，并在首次恢复时重新建立基线。
额度提醒： 个人账号展开后看到 Cursor Models 和 Other Models 的额度百分比。每一份各自在 50%、80%、100% 提醒一次，不需要设置美元金额。某一份额度没有百分比时不提醒。点击 设置 → 配置金额提醒，或在命令面板执行同名命令，仍可另设一笔美元提醒：选择 On-Demand（按需费用，默认） 或 套餐内用量，再输入最多两位小数的美元金额。这是两种独立的接口金额，不会相加；0 只关闭这笔金额提醒。alertEnabled 总开关同时控制额度提醒和金额提醒。
额度百分比和金额提醒都按账单周期的当前值检查。50%、80%、100% 的提醒记录在重载后保留；一次轮询跨过多个档位时，只提醒最高档，并将较低档标记为已达到。两份额度各自记档，互不影响。金额提醒低于当前金额时，可能立即提醒。账号、账单周期、金额或口径变化后使用独立记录。本机最多保留最近 100 组配置的哈希标识和已达到档位，不在该记录中保存会话 Token。所选美元金额缺失或周期日期无效时，不发这笔金额提醒；额度百分比仍照常提醒。
今日消费： 面板展示今日费用、Token、请求数和按 Token 排序的前三个模型。按本机时区确定“今天”，范围限于当前账单周期及最近获取的快照；状态栏悬停也可查看今日 Token 和请求数。卡片只累加事件接口返回的正数美分。当天加总为 0 时显示「接口未返回费用」。没有任何费用字段时仍显示「暂无费用数据」。部分请求缺价或历史不完整时会标注，事件费用可能与最终账单不同。刷新详情可补拉历史并更新卡片。
连接诊断： 点击面板里的 设置 → 连接诊断，或在命令面板执行 查看连接诊断。输出报告包括最近使用的认证来源（本机会话／手动 Token／不可用）、最近尝试和成功获取时间、汇总／事件／模型接口结果、连续失败次数、当前轮询间隔及缓存历史完整性。不展示 Token、Cookie 或原始账号 ID，也不会发送报告。诊断是当前状态的快照；刷新用量后重新打开可查看更新结果，轮询超时时部分接口状态可能未知。
为什么不估算美元？
自助套餐的用量事件里，美元经常是 $0（chargedCents: 0），即使已经消耗 token。用 token × 官网单价对不上账单：套餐额度、团队 / 企业折扣、Cursor Token Rate 都在服务端结算。只有事件接口返回大于 0 的美分，或汇总接口返回金额时，才显示 $。单次费用缺失或为 0 时，最近消耗和加总为 0 的今日消费显示「接口未返回费用」。Token 始终按 token 显示。这时 费用 指标会空，请看 Token。套餐内已用、On-Demand 和金额提醒仍会显示真实的 $0.00。
状态栏一直是 Set Token？
先确认本机已登录 Cursor。自动读取仍失败时，用 Set Session Token 粘贴 WorkosCursorSessionToken。
远程 SSH / WSL 读不到用量？
扩展必须装在本机 Cursor，不要装到远端。它是 UI 扩展，只读本机 state.vscdb。
提醒太频繁 / 从不响？
阈值是连续两次成功轮询之间的正向增长。可调整 pollingInterval 和对应 alertThreshold.*；0 表示有增长就提醒。新请求提醒无需打开详情，但后台每次只能检查最新 100 条事件。失败恢复、账号或账单周期变化时会重置相应基线。
详情面板数字没跟着状态栏变？
状态栏按轮询间隔刷新。面板在点 刷新（或重新打开）前保留图表，并保留仍在有效范围内的日期选择。状态栏有新数据时，面板顶部会提示刷新；请求错误会即时更新提示，无需重绘图表。
为什么提示缓存数据或历史不完整？
已有用量后请求失败，状态栏会显示警告，悬停可查看错误原因；汇总请求失败时还会显示最近成功获取的时间。详情面板即使保留旧用量，也会展示错误。模型汇总获取失败时，会保留同一账号、同一账单周期内已有的汇总缓存。
历史请求每次最多拉取 30 页，每页 100 条。分页失败、达到页数上限或两次拉取之间存在缺口时，会标记历史不完整。图表只统计已有记录，缺失日期不能视为已确认的零消费。临时失败可点击 刷新 重试；每次全量请求仍有 3,000 条上限，因此重复刷新不保证覆盖更大的账单周期。
需要 Node.js 20 或更新版本及 npm。
npm install
npm test
mkdir -p vsix
npx @vscode/vsce package --no-dependencies --out vsix/cursor-token-usage-1.1.5.vsixnpm test 会先编译，再运行基于模拟接口的回归测试，不访问真实 Cursor 账号。打包前也会自动编译，安装包不包含测试文件。
当前版本生成 cursor-token-usage-1.1.5.vsix，安装后执行 Developer: Reload Window。本地构建不会发布到 Open VSX 或 GitHub Releases。
- 首屏保留三张统计卡片和单行 C / O 额度；顶部展示套餐与账单周期，额度下方显示「重置倒计时：…」，全称和内外环关系支持悬停及键盘查看
- 明确请求数、已知费用、本周期 Token 的统计口径；未知额度不再当作零用量，缺失费用不显示为
$0.00，历史不完整时缺失日期仍为未知 - 趋势线改为保形曲线，经过真实每日数据点，不产生额外峰谷或负值，遇到未知日期断开；保留堆叠柱和三种指标
- 工具栏精简为等高的刷新与设置按钮；设置菜单分组、细箭头、悬停与焦点反馈随主题适配，支持 Esc 和点击外部关闭
- 刷新显示忙碌状态并合并重复请求；刷新中打开详情仍补拉历史，面板刷新后恢复滚动位置与按钮焦点，并保留有效筛选
- 恢复趋势与模型区的简短说明；清除筛选仅在条件变化后出现，每日数据表使用低强调的折叠入口，模型按钮支持键盘筛选和焦点明细
- 改善窄分栏、表格局部横向滚动和减少动态效果适配；提醒配置明确暂停／恢复、增长量及单位，并校验阈值边界
- 同步中英文市场简介、使用说明和当前界面示例；51 项回归测试覆盖数据缺失、刷新竞争、曲线边界和周期展示等行为
- 趋势图仍是输入 / 输出 / 缓存堆叠柱加折线，使用主题色和虚线网格。日期轴默认当前账单周期，From / To 可在周期内收窄
- 用量可筛全部、Cursor Models（Grok、Composer、Auto）或 Other Models（Claude、GPT、Gemini 这类第三方模型）。指标可在 Token、请求数、费用之间切换
- 占比进度条一节改名为模型用量。悬停跟着鼠标走，并随指标变化。点击一行可筛选趋势。状态栏悬浮窗里的短表标题仍是「按模型」，区块之间有分割线
- 请求数、接口费用和 Token 合计放在页面右上角。套餐卡片是双环：外环 Other Models，内环 Cursor Models，旁边是 C / O 和重置倒计时。环心颜文字跟着较高的那一份额度变化：40% 以下
(^_^)，80% 以下(・_・)，100% 以下(>_<)，超过 100% 是(×_×)。悬停表情可看说明 - 使用趋势、模型用量和最近消耗固定展开。今日消费和额度提醒默认收起
- 额度提醒对 Cursor Models 和 Other Models 分别在 50%、80%、100% 各提醒一次，重载后同一档不重复。面板按钮和命令改为「配置金额提醒」，只在接口返回对应美元时生效；没有套餐内美元时不再显示「暂无用量金额」
- 企业账号如果接口只返回套餐内已用美元和上限，环是单环，环心仍用同一套颜文字；额度按已用金额相对上限的百分比在 50%、80%、100% 提醒，状态栏显示已用金额和上限。接口如果同时返回两份额度百分比，则和个人版一样是双环
- 最近消耗和侧边栏展示单次费用
- 单次费用缺失或为 0，以及今日消费加总为 0 时，显示「接口未返回费用」
- 套餐内已用、On-Demand 和周期预算仍显示真实的
$0.00 - 最近消耗表的表头和单元格居中
- 今日消费与账单周期预算支持独立折叠，默认收起，摘要保留关键数值和异常提示
- 刷新、关闭重开面板及重载编辑器后恢复展开状态，不覆盖趋势图筛选条件
- 加宽详情布局并增大趋势图，面板宽度变化时自动重绘并调整日期标签密度
-
新增跨重载保留的周期预算提醒（50%、80%、100%）、今日消费卡片和连接诊断
-
缺失的事件费用保留为暂无数据，不再按零处理
-
修复自动轮询被跳过、手动刷新卡住的问题，并清理已完成请求的超时定时器
-
账单周期或账号变化时重置缓存历史和提醒基线
-
后台轮询支持新请求提醒，补拉旧历史不会被当作新消费
-
分页失败或达到上限时明确标记数据不完整；部分接口失败时保留已有历史和模型汇总
-
状态栏和详情面板展示请求失败及缓存数据提示，后台失败也会即时提示
-
新增回归测试（
npm test），打包前自动编译
- 双池比例一律显示一位小数（
42.3%、0.2%） - 首次启动需确认后才读取本机 Cursor 会话（
state.vscdb） - 状态栏、提醒、详情面板都不用时停止后台轮询
- 连续请求失败后指数退避（上限 10 分钟）
- 双池比例低于 1% 时显示一位小数（
0.2%），不再四舍五入成0% - Tracker 日志打印
autoPercentUsed/apiPercentUsed/totalPercentUsed原始值
- 打开或刷新详情面板时翻页拉取用量事件（每页 100 条，最多 30 页）
- 状态栏轮询保持轻量（一页），并把新事件合并进已有全量列表，不会用短列表覆盖
- 打开 / 刷新面板会等正在进行的轮询结束，不再把全量拉取直接跳过
- 日期选择范围跟账单周期；趋势图默认近 7 天；From / To 可跨月
- 后台轮询不再整页重绘面板；状态栏已更新时会提示点刷新
- 费用图同样画趋势线；图例随 Token / 费用 Tab 切换并居中
- 接口没返回美分时费用 Tab 为空（不按官网单价估算）
- 重发 1.0.7：Open VSX 上 1.0.7 发过又删，版本号已占用不能再发
- 中英文首页标题区整块居中
- 商店短描述改为 Cursor token 计费（不再用泛称「用量」）
- README：只写 Cursor IDE；安装走 Open VSX；去掉 VS Code Marketplace
- 读不到会话时状态栏显示 Set Token
- 英文 Token 单位用 K/M，中文满万仍用「万」
- 窗口失焦时降低轮询频率
- 按模型进度条显示占总用量比例
- 趋势图：Token 为输入 / 输出 / 缓存堆叠柱 + 折线；费用仅在接口返回美分时绘制；可按模型筛选；悬停看明细；日期范围可选
- 团队 / 企业：始终显示 On-Demand（接口美分，含 $0）
- Webview 跟随 Cursor 浅色 / 深色主题（
--vscode-*变量）
欢迎 Issue 和 Pull Request。
- Fork 本仓库
git checkout -b feature/your-feature- 提交更改
- 开 Pull Request
A Cursor IDE extension that shows live Cursor token billing on the status bar
中文 · English · Quick Start · Features · Authentication · UI · FAQ
Cursor now bills by tokens in two pools (not the old “fast-premium requests + dollars” model). This extension reads the live dashboard APIs and switches the display by account type: individual accounts see two-pool percentages; Team / Enterprise see included spend vs limit.
Status bar Individual: C xx% · O xx%. Team / Enterprise: included used vs limit (API cents, not a local estimate) |
Details panel Click the status bar for a double usage ring, model-usage share bars, recent events with cost, and a trend chart |
|---|---|
Account-aware Type comes from the API (individual / team / enterprise), not guessed from the token |
Usage alerts Notify when the delta between two polls exceeds a threshold; metrics and thresholds are configurable |
Also:
- Auto refresh, default 30 seconds; slower while the window is unfocused; pauses when the status bar, alerts, and details panel are all unused; backs off after consecutive failures
- Status-bar polls fetch one page of up to 100 events; opening or refreshing the details panel fetches billing-cycle history, up to 30 pages (3,000 events) per refresh
- Failed or capped history fetches are marked incomplete; fetch failures show warnings, and available cached data is retained within the same account and billing cycle
- English / Chinese UI, follows the editor language
- Universal VSIX for macOS / Windows / Linux; after first-run consent, reads the local Cursor session (
state.vscdb) - UI extension (
extensionKind: ui): on SSH Remote, WSL, or Dev Containers it still reads the local login - Shows
$for a positive per-event cost and for summary amounts, including a real$0.00; does not estimate invoices from list prices - Trend chart defaults to the current billing cycle; From / To can narrow that range
- Today’s usage shows API-reported cost, tokens, requests and top models; a zero event-cost total is labeled “API did not return a cost”
- Cursor Models and Other Models each notify at 50%, 80% and 100%. The amount alert still uses those levels when the API returns dollars. Connection diagnostics show authentication source, endpoint results and polling state
Install from Open VSX (Cursor’s extension marketplace). Search Cursor Token Usage, or:
cursor --install-extension akitogo.cursor-token-usage- For this source version, build
cursor-token-usage-1.1.5.vsixusing Build from Source, or obtain the matching version from Releases if published - Drag it into Cursor, or
Cmd+Shift+P(Windows:Ctrl+Shift+P) →Extensions: Install from VSIX... - Run
Developer: Reload Window
The status bar should show usage. If the session is missing it shows Set Token — see Authentication.
On first launch the extension asks before reading the local Cursor session. After you allow it, it reads cursorAuth/accessToken and the user id from state.vscdb, builds a WorkosCursorSessionToken cookie, and sends it to cursor.com only. You can decline and set a token manually instead.
| OS | Session file |
|---|---|
| macOS | ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb |
| Windows | %APPDATA%\Cursor\User\globalStorage\state.vscdb |
| Linux | ~/.config/Cursor/User/globalStorage/state.vscdb |
Auto-detect reads state.vscdb directly, including uncheckpointed WAL pages. It does not need Python or the sqlite3 command. If the local session cannot be read, use Set Session Token.
If auto-detect fails:
- Command Palette → Cursor Token Usage: Set Session Token
- Paste
WorkosCursorSessionToken(format:userId%3A%3AaccessToken) - The token is stored in VS Code SecretStorage, never in
settings.json
To copy the cookie: open cursor.com → DevTools → Application → Cookies → WorkosCursorSessionToken.
Remote workspaces: this extension runs in the local Cursor process. Do not install it on the SSH / WSL / container host.
The status-bar hover shows progress bars for the active pools or included spend, a short by-model table, the reset countdown, and links to open details or refresh. Dividers separate those blocks.
The trend chart stacks input, output, and cache, with a line over the total. Usage can be all, Cursor Models (Grok, Composer, Auto), or Other Models (third-party models such as Claude, GPT, and Gemini), and the metric can be tokens, requests, or cost. The date axis defaults to the current billing cycle. Usage trend, Model usage, and recent usage stay expanded; the usage, metric, category, and export controls stay in each card header. Request count, API cost, and total tokens sit at the top right of the page. The header shows the billing period; the reset countdown (for example, “Reset in: 9d 11h”) sits below the allowance percentages. The included-usage card shows C / O percentages on one line, with full pool names and ring mapping in tooltips: the outer arc is Other Models, the inner arc is Cursor Models. The center kaomoji follows the higher pool: (^_^) under 40%, (・_・) under 80%, (>_<) under 100%, and (×_×) after 100%. Hover the face for the matching note. When a Team or Enterprise summary returns included dollars and a limit instead of the two pool percents, the ring stays a single arc, the center still uses this kaomoji, and allowance alerts use that included-spend percent at 50%, 80% and 100%. The status bar shows the dollar amounts. If that summary also returns the two pool percents, the card matches the individual double ring.
Recent usage is a table of the latest rows (displayCount, default 5): time, model, kind, tokens, and cost. The category menu defaults to All. Models and Automation (such as Grok BOT) are split before that limit, so automation rows do not hide later model usage. Export CSV writes every fetched event, not only the visible rows. Cells that spreadsheets would treat as formulas are prefixed. A positive per-request amount from the events API is shown in dollars. A missing amount or an explicit zero is labeled “API did not return a cost”. Expanding the same row in the sidebar shows that cost. Included spend, On-Demand, and the amount alert still show $0.00 when the summary API reports zero.
Model usage is a share bar. The metric control switches the bar among tokens, requests, and cost. Hover follows the pointer and shows the matching breakdown: input / output / cache, included versus on-demand requests, or API cost. Click a row to filter the trend. The status-bar hover still uses the shorter heading By Model.
Bar colors: green < 40%, yellow < 80%, orange ≥ 80%, red ≥ 100%. Usage ≥ 80% tints the status bar warning; ≥ 100% tints it error.
The toolbar keeps Refresh and Settings at the same height. Settings groups general actions, alerts and diagnostics with thin separators and a small disclosure arrow, using the Cursor theme. Tab navigates the controls; Escape returns focus to Settings; clicking outside or choosing an action closes the menu.
Refresh shows a busy state and coalesces repeated requests. Opening details during a refresh still attempts a paginated history fetch. The toolbar shows when data was fetched. Refreshing with the panel button restores its focus and scroll position while preserving valid filters.
The overview shows Requests, Known cost, and Cycle tokens, with scope details in a tooltip, independently of trend filters. Event cost is not the final bill. Missing allowances use a neutral (?), not a comfortable zero-usage face. In incomplete history, dates without fetched records are unknown and break the trend line; cost tooltips report missing prices. Shape-preserving cubic interpolation avoids artificial peaks, dips and negative consumption.
Clear filters appears when filters change and restores the cycle date range, all pools and all models while retaining the selected metric. Model names are native buttons supporting keyboard activation and focus-based details; Escape dismisses model details. View daily data uses a muted disclosure row, a thin arrow and a separator; its text becomes stronger and the arrow turns when expanded. The table follows the trend filters and is bounded to 400 days, with a notice for longer ranges. Short subtitles explain the daily trend and model filtering; detailed scope notes stay in tooltips. Narrow panels stack model names and allow tables to scroll horizontally. Reduced-motion preferences disable transitions and smooth scrolling.
Today and Allowance alerts are collapsed by default to keep the trend chart prominent. Click either heading (or focus it with Tab and press Enter/Space) to expand or collapse it. Collapsed summaries retain key amounts, tokens, allowance progress and partial-data/paused-alert indicators. Each section's state is saved locally and restored after refresh, reopening the panel or reloading Cursor.
The panel uses up to 1,000 px of available width. The trend chart redraws to fit the panel, with date-label density adapting to its width. Collapsing Today or Allowance alerts, or resizing the panel, preserves the selected dates, model, usage pool and metric. The cost metric only draws when at least one event cost is greater than zero. Background polls update the status bar and panel status banners while preserving the chart and date selection. Fetch errors appear immediately in an open panel; after recovery, a banner asks you to Refresh for current details.
| Setting | Default | Description |
|---|---|---|
cursorTokenUsage.budgetAmount |
0 | Dollar amount alert; 0 disables that alert. Pool alerts at 50%, 80% and 100% stay on |
cursorTokenUsage.budgetMetric |
onDemand |
Amount-alert basis: onDemand or included; global application setting |
cursorTokenUsage.displayCount |
5 | Recent usage rows in the details panel (does not limit the trend chart) |
cursorTokenUsage.pollingInterval |
30 | Poll interval in seconds (5–300) |
cursorTokenUsage.showStatusBar |
true | Show the status bar item |
cursorTokenUsage.statusBarAlignment |
right |
Status bar side: left / right |
cursorTokenUsage.alertEnabled |
true | Master switch for usage-change, allowance and amount alerts |
cursorTokenUsage.alertItems |
newSession overallSpending cursorModels otherModels totalTokens |
Metrics to watch |
cursorTokenUsage.alertThreshold.newSession |
2 | New usage requests in one poll |
cursorTokenUsage.alertThreshold.overallSpending |
1 | Included spend change ($) |
cursorTokenUsage.alertThreshold.cursorModels |
10 | Cursor Models pool change (percentage points) |
cursorTokenUsage.alertThreshold.otherModels |
10 | Other Models pool change (percentage points) |
cursorTokenUsage.alertThreshold.onDemandSpending |
1 | On-demand spend change ($) |
cursorTokenUsage.alertThreshold.totalTokens |
100000 | Total tokens change |
| Command | What it does |
|---|---|
| Show Token Usage Details | Open the details panel (same as clicking the status bar) |
| Refresh Token Usage | Fetch usage; wait for an active poll first, and fetch history if the details panel is open |
| Set Session Token | Paste / clear the session token |
| Set Polling Interval | 5–300 seconds |
| Set Status Bar Side | Left / right |
| Configure Usage Alerts | Toggle, pick metrics, set thresholds |
| Configure Amount Alert | Select the cost basis and dollar amount |
| Show Connection Diagnostics | Open a read-only report of connection and polling state |
- Command Palette → Configure Usage Alerts, or Settings → Configure Usage Alerts in the details panel
- Use Pause all alerts / Resume all alerts, choose metrics and set thresholds as needed
- Monitors: new requests, included spend, Cursor Models %, Other Models %, On-Demand spend, total tokens
- A threshold of
0means any positive increase fires an alert. Inputs identify requests, USD, percentage points or tokens, and reject blank, non-finite, negative or above-1e12values
Thresholds are the positive delta between consecutive successful polls for the same account and billing cycle, not a lifetime or absolute cap. Example:
onDemandSpending = 1.0fires when on-demand spend rises by $1.00 or more between those polls.
New-request alerts work with the details panel closed. They count newly observed requests in the fetched page; loading older history does not trigger them. A background poll fetches at most 100 events, so requests beyond that page may be missed during busy periods or long gaps. Opening details loads more history but does not retroactively alert on older requests.
Changing the account or billing cycle resets the alert baseline. The first successful poll after a fetch failure establishes a new baseline; event or model-total failures also suppress the affected alerts during failure and the first recovery poll.
Allowance alerts: on an individual account the card shows the Cursor Models and Other Models percentages. Each pool notifies once at 50%, 80% and 100%, without a dollar amount. A pool with no percentage does not notify. Settings → Configure Amount Alert in the panel, or the same command in the Command Palette, can still set a separate dollar alert: choose On-Demand (default) or Included usage, then enter a USD amount with up to two decimal places. These are separate API amounts; the extension does not add them together. 0 disables only that amount alert. Both settings apply globally, and alertEnabled controls the allowance alerts and the amount alert.
Pool percentages and the amount alert use the current billing-cycle value. Each 50%, 80% and 100% milestone is remembered across reloads. If one poll reaches several new levels, only the highest is notified and lower levels are considered reached. The two pools keep separate records. Configuring an amount alert below current usage can notify immediately. A new account, billing cycle, amount or cost basis starts a separate milestone record. Up to 100 recent combinations are retained locally as hashed scope keys and reached levels; session tokens are not stored in this record. A missing dollar amount or invalid cycle dates suppress that amount alert; pool percentages still notify.
Today: the details panel shows cost, tokens, request count and the top three models by tokens. “Today” uses the computer’s local timezone, limited to the current billing cycle and the last fetched snapshot. The status-bar tooltip includes today’s tokens and requests. The card sums positive per-event cents. A today total of zero is labeled “API did not return a cost”. If no event included a cost field, it stays “Cost unavailable”. Partially priced or incomplete history is labeled, and event costs may differ from the invoice. Refresh the details panel to fetch more history and update these cards.
Diagnostics: use Settings → Connection Diagnostics in the panel or Show Connection Diagnostics in the Command Palette. The output report includes the last-used authentication source (local session / manual token / unavailable), last attempt and successful fetch, summary/events/model endpoint results, consecutive failures, current polling interval and cached-history completeness. It displays no token, cookie or raw account ID and sends no report anywhere. The report is a snapshot: refresh usage and reopen diagnostics for new results. A timed-out poll can leave endpoint results unknown.
Why not estimate dollars?
Self-serve usage events often return $0 (chargedCents: 0) even when tokens were used. Token × public list price will not match the invoice: included quota, Team / Enterprise discounts, and Cursor Token Rate are applied server-side. $ is shown only when the API returns a positive per-event amount, or a summary amount from the billing API. A missing or zero event cost is labeled “API did not return a cost” in Recent usage and on a zero Today total. Token counts are always tokens. The Cost metric stays empty in that case; use Tokens. Included spend, On-Demand, and the amount alert still show a real $0.00.
Status bar stuck on Set Token?
Confirm Cursor is signed in locally. If auto-detect still fails, use Set Session Token and paste WorkosCursorSessionToken.
No usage on SSH / WSL?
Install the extension in local Cursor, not on the remote host. It is a UI extension and only reads the local state.vscdb.
Alerts too noisy / never fire?
Thresholds are positive increases between consecutive successful polls. Adjust pollingInterval and the matching alertThreshold.*. 0 means any increase. New-request alerts work without opening details, but background polling can only inspect the latest 100 events per fetch. Recovery and account or billing-cycle changes reset the relevant baseline.
Details panel looks stale?
The status bar refreshes on the polling interval. The panel keeps its chart until you click Refresh (or reopen it), and preserves valid date selections. A banner appears when the status bar has newer data. Fetch-error banners update immediately without rebuilding the chart.
Why is there a cached-data or incomplete-history warning?
If a fetch fails after usage has loaded, the status bar shows a warning and its tooltip explains the error. A summary failure also shows the last successful fetch time. The details panel displays the error even while cached usage remains visible. Failed model-total fetches retain available cached totals for the same account and billing cycle.
History fetches stop after 30 pages of 100 events. A failed page, a page limit, or a gap between fetched pages leaves history marked incomplete. Charts show only available events; missing dates must not be interpreted as confirmed zero usage. Click Refresh to retry transient failures. The 3,000-event limit applies to each full fetch, so repeating it cannot guarantee complete history for a larger cycle.
Use Node.js 20 or later and npm.
npm install
npm test
mkdir -p vsix
npx @vscode/vsce package --no-dependencies --out vsix/cursor-token-usage-1.1.5.vsixnpm test compiles the extension and runs regression tests with simulated API responses; it does not access a real Cursor account. Packaging also compiles automatically and excludes test files.
This version produces cursor-token-usage-1.1.5.vsix. Install it, then run Developer: Reload Window. Building locally does not publish the package to Open VSX or GitHub Releases.
- Keep three overview cards and compact C / O percentages; show the plan and billing period in the header, the reset countdown below allowances, and full pool names and ring mapping on hover or keyboard focus
- Clarify requests, known costs and cycle tokens; keep unknown allowances neutral, missing costs unavailable and missing dates unknown when history is incomplete
- Use shape-preserving curves through measured daily points without artificial peaks, dips or negative values; break at unknown dates while retaining stacked bars and all three metrics
- Keep equal-height Refresh and Settings controls; group menu actions with thin separators, theme-aware arrows, hover and focus states, Escape and outside-click dismissal
- Show refresh progress and coalesce duplicate requests; opening details mid-refresh still fetches history, while panel refresh restores scroll and button focus and preserves valid filters
- Restore short trend and model subtitles; show Clear filters only when needed, use a subdued daily-table disclosure, and support keyboard model filtering and focused details
- Improve narrow panels, local table scrolling and reduced-motion support; clarify pause/resume, delta units and threshold validation in alert settings
- Update English and Chinese listing copy, instructions and UI examples; 51 regression tests cover missing data, concurrent refreshes, curve bounds and billing-period display
- Keep the trend chart’s input / output / cache stack, trend line, theme colors and dashed grid. Default the date axis to the current billing cycle; From / To can narrow that range
- Filter usage by All, Cursor Models (Grok, Composer, Auto) or Other Models (third-party models such as Claude, GPT, and Gemini). Switch the metric among tokens, requests and cost
- Rename the share-bar section to Model usage. Its hover follows the pointer and changes with the metric. Click a row to filter the trend. The status-bar hover still uses the shorter heading By Model, with dividers between blocks
- Put request count, API cost and total tokens at the top right. The included-usage card is a double ring: outer Other Models, inner Cursor Models, with C / O and the reset countdown beside it. The center kaomoji follows the higher pool:
(^_^)under 40%,(・_・)under 80%,(>_<)under 100%, and(×_×)from 100%. Hover the face for the note - Keep Usage trend, Model usage and recent usage expanded. Today and Allowance alerts stay collapsed by default
- Allowance alerts notify Cursor Models and Other Models separately at 50%, 80% and 100%, once per level across reloads. The panel button and command are Configure Amount Alert, and that dollar alert runs only when the API returns the amount. A missing included-usage dollar no longer shows “usage amount unavailable”
- When a Team or Enterprise summary returns included dollars and a limit instead of the two pool percents, the ring stays a single arc and the center still uses the kaomoji. Allowance alerts use that included-spend percent at 50%, 80% and 100%, and the status bar shows the dollar amounts. If the summary also returns the two pool percents, the card matches the individual double ring
- Show API cost beside tokens in recent usage and when a sidebar row is expanded
- Label a missing or zero per-event cost, and a zero Today total, as “API did not return a cost”
- Keep a real
$0.00for included spend, On-Demand, and the billing-cycle budget - Center the recent-usage table headers and cells
- Make Today and Billing-cycle budget independently collapsible, initially collapsed with key values and warnings visible
- Remember section states across refreshes, panel reopenings and editor reloads without overwriting chart filters
- Widen the details layout and enlarge the trend chart; redraw the chart and adapt date labels when the panel resizes
-
Add persistent billing-cycle budget milestones (50%, 80%, 100%), today’s usage cards and connection diagnostics
-
Preserve missing event costs as unavailable instead of treating them as zero
-
Fix polling locks that skipped automatic updates or stalled manual refreshes; clear completed timeout timers
-
Reset cached history and alert baselines when the billing cycle or account changes
-
Enable new-request alerts during background polling without treating older history as new usage
-
Flag failed or capped pagination as incomplete; retain available history and cached model totals on partial failures
-
Show fetch errors and cached-data warnings in the status bar and details panel, including background failures
-
Add regression tests (
npm test) and compile automatically before packaging
- Pool percentages always show one decimal (
42.3%,0.2%) - First launch asks before reading the local Cursor session (
state.vscdb) - Background polling stops when the status bar, alerts, and details panel are all unused
- Consecutive fetch failures use exponential backoff (capped at 10 minutes)
- Pool percentages below 1% show one decimal (
0.2%) instead of rounding to0% - Tracker log prints raw
autoPercentUsed/apiPercentUsed/totalPercentUsed
- Paginate usage events (100 per page, up to 30 pages) when the details panel is opened or refreshed
- Status-bar polls stay light (one page) and merge new events into the full list; they never replace a completed event list with a shorter one
- Opening or refreshing the panel waits for an in-flight poll instead of skipping the full fetch
- Date picker
min/maxfollow the billing cycle; default chart window is the last 7 days; From / To can span months - Background polling does not rebuild the panel; a banner asks you to Refresh when the status bar has newer data
- Cost chart also draws a trend line; the legend switches with the Token / Cost tab and is centered
- Cost tab stays empty when the API returns no cents (no list-price estimate)
- Republish of 1.0.7: Open VSX reserved 1.0.7 after it was published and deleted
- README header (EN / 中文) is centered as one block
- Store listing copy: Cursor token billing (not generic “usage”)
- README: Cursor IDE only; Open VSX install path; no VS Code Marketplace
- Status bar shows Set Token when the session is missing
- English token units use K/M; Chinese still uses 万
- Slower polling while the window is unfocused
- Per-model bars show share of total tokens
- Trend chart: Token stacked bars (input / output / cache) + line; Cost bars only when the API returns cents; model filter; hover tooltip; selectable date range
- Team / Enterprise: On-Demand always shown (API cents, including $0)
- Webview follows Cursor light / dark via
--vscode-*theme colors
Issues and pull requests are welcome.
- Fork this repo
git checkout -b feature/your-feature- Commit your changes
- Open a pull request
Created by Akito-Go — star the repo if this helps.