Token Tracker

Name: Token Tracker
Author: LLM Mart

本地 AI Agent Token 消耗追踪/分析工具，支持 Claude Code、Codex 和 Kimi Code。

自定义 StatusLine 状态栏 + CLI Dashboard，实时查看 token 用量、等效成本、限额状态。

English

Token Tracker Daily

功能亮点

多 Agent 统一追踪 — Claude Code + Codex + Kimi Code 统一读取，多 Agent 按来源分组
状态栏集成 — Claude Code 用官方 StatusLine 接口；Codex 业界首创伪 statusline 方案（hook 注入两行真彩色状态栏，把官方未开放的能力在 Codex 里做了出来）；Kimi Code 用官方 status_line 接口
实时侧边栏 — tt sidebar 窄窗格常驻面板：全部活跃会话一屏总览（状态灯 + 最近提示词 + 「下一步」建议），点击会话直达对应 iTerm2 / tmux 窗格
当前会话自动分屏 — Codex 中显式执行 $tt-sidebar，在原会话右侧自动打开 1/3 宽度的独立提示词侧边栏
限额监控 — 实时 5h / 7d 配额百分比 + 重置倒计时
多维成本分析 — 会话 / 日 / 周 / 月多维报表，等效成本统计
定价识别 -- litellm 在线定价 + 内置官方价双层兜底，覆盖 GPT-6 Astra、Claude Fable 5.1 及 Claude / OpenAI / Gemini / Grok 和国产主流（Kimi / GLM / Qwen / 豆包 / DeepSeek / MiniMax / MiMo）；按单次请求计算长上下文阶梯价与 DeepSeek 峰谷价（周末全天谷价），Codex 缓存读写分别计价；未知模型优先套用已知系列价，仍无法识别时提示缺价
会话洞察 — 项目、模型、时长、消息数一览
多主题统一配色 — 6 套主题（Catppuccin 全家 + Nord + Dracula），CLI 报表与各 Agent 状态栏同源，tt theme 一键切换
零配置 — 自动检测已安装的 Agent，直接读取本地数据
隐私安全 — 数据纯本地存储，不采集、不上传

StatusLine 状态栏

tt setup 自动为 Claude Code、Codex 和 Kimi Code 配置状态栏，脚本更新时自动升级。

Claude Code（官方接口）

基于 Claude Code 官方自定义 StatusLine 接口，数据完全来自本地 Claude，无任何推测。

状态栏接管是可选的：已有自定义 statusLine 时默认保留你的配置（向导里也可随时选 No），报表命令完全不受影响。注意：不接管时 tt status 的 CC 订阅额度段将没有数据来源（CC 配额只经状态栏脚本落盘）。

Claude Code StatusLine

四行布局字段详解

行	字段	说明
1	`[项目](分支 +12 -3)`	项目名（加粗）+ Git 分支（未提交修改标 `*`），括号内附工作区相对 HEAD 的增删行数
1	`Total: 1.2M`	本次会话累计消耗 token（输入+输出+cache，解析 transcript 得出）
1	`Cost: $35.51`	本次会话等效成本（Claude Code 自带，按官方计费，准确）
1	`Code: +208 -8`	本会话 Claude 写 / 删的代码行数（`+` 绿 `-` 红，与 git 变动同配色）
2	`Limit: 5h: ██░ 31% (1h19m)`	5 小时滑动窗口配额（仅订阅模式；括号内重置倒计时）
2	`7d: ██░ 11% (5d8h)`	7 天滑动窗口配额
2	`1.0M Ctx: ██░ 20%`	上下文窗口总大小及已用占比
3	`Tokens: in 392k, out 937, cache 388k`	当前上下文窗口的 token 构成（注意：非会话累计，会随 compact 变化）
3	`Out TPS: 60 tokens/s`	本轮 output token 生成速度（含 thinking；空闲帧保留上次值）
4	`Model: Opus 4.8/xhigh/nofast`	模型名 / reasoning 级别 / 是否 fast 模式
4	`Duration: 1h33m`	当前会话已持续时间
4	`Remote: github`	代码仓库 host（去顶级域）

终端宽度不足时会自动降级：先隐藏重置倒计时，再将进度条简化为百分比数字。API 模式无订阅配额，第 2 行只显示 Ctx。

Codex（伪 statusline，业界首创）

Codex 官方暂不支持自定义 StatusLine。Token Tracker 通过 hook 注入了一个伪 statusline——每次回答完成后，在回答尾部追加两行真彩色状态栏。这是目前业界少见的把状态栏能力在 Codex 里做出来的实现方案。

Codex StatusLine

两行布局：

L1 [项目](分支 +A -D) | Total: <会话累计 token> | Model: <模型推理强度> —— Total 橙、Model 红；第三方 API provider（如 DeepSeek）无订阅配额，L1 加显示会话 Cost（按逐请求时间与上下文档位套用内置官方价估算）
L2 Limit: 5h <进度条> % (reset <倒计时>) | 7d <进度条> % (reset <倒计时>) | <窗口> Ctx <进度条> % —— 配额按当前会话 / 同 model_provider 取数，多账号多 provider 混跑不串数据；无配额数据时不挂 Limit: 前缀

渲染 24-bit 真彩色、不进模型上下文（实测），配色跟随当前主题（与 CLI 报表 / CC 状态栏同源，tt theme 切换三者一起变）。tt unsetup 一并移除。

Kimi Code（官方接口）

基于 Kimi Code 官方 status_line 接口（tui.toml），单行真彩色状态栏：

项目 / 分支 / 模型 / 权限模式来自 Kimi 官方快照（快照无思考档位，effort 取自会话 wire 里实际请求的 thinkingEffort），分支段的未提交增删行 / 未跟踪数按 git diff --numstat + git ls-files 统计（同 CC 状态栏）；Total 与 Cost 由状态栏脚本按会话 wire.jsonl 增量累计（offset 缓存，每秒级调用只读新增部分），成本按内置 Kimi 官方定价估算
macOS / Linux / Windows 全平台支持（Windows 控制台 GBK 编码、后台刷新进程 detach 方式均已适配）
已有自定义 status_line.command 时默认不覆盖（向导里选 No 也完全不碰）；tt unsetup 精确还原

报表速览

tt status — 今日实时面板（今日合并概览 + 5h/7d 额度 + 今日会话）

Status

tt weekly — 周报：本周分析卡片 + 每日趋势柱状图 + 周 / 项目 / 模型趋势