tokentracker-cli 0.14.6 → 0.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -78,7 +78,7 @@ Upgrade with `brew upgrade --cask mm7894215/tokentracker/tokentracker`. The tap
78
78
 
79
79
  ## ✨ Features
80
80
 
81
- - 🔌 **15 AI tools out of the box** — Claude Code, Codex CLI, Cursor, Gemini CLI, Kiro, OpenCode, OpenClaw, Every Code, Hermes Agent, GitHub Copilot, Kimi Code, CodeBuddy, oh-my-pi, Kilo CLI, Kilo Code
81
+ - 🔌 **16 AI tools out of the box** — Claude Code, Codex CLI, Cursor, Gemini CLI, Kiro, OpenCode, OpenClaw, Every Code, Hermes Agent, GitHub Copilot, Kimi Code, CodeBuddy, Grok Build, oh-my-pi, Kilo CLI, Kilo Code
82
82
  - 🧩 **Skills manager** — browse 250+ public skills from `anthropics/skills`, `ComposioHQ/awesome-claude-skills`, `skills.sh` and any GitHub repo you add; install once and sync to Claude / Codex / Gemini / OpenCode / Hermes with per-target toggles; one-click Undo
83
83
  - 🏠 **100% local** — Token data never leaves your machine. No account, no API keys.
84
84
  - 🚀 **Zero config** — Hooks auto-install on first run. From zero to dashboard in 30 seconds.
@@ -157,13 +157,15 @@ Upgrade with `brew upgrade --cask mm7894215/tokentracker/tokentracker`. The tap
157
157
  | **Kimi Code** | ✅ Auto | Passive `wire.jsonl` reader (`~/.kimi/sessions/**/wire.jsonl`) |
158
158
  | **oh-my-pi (Pi Coding Agent)** | ✅ Auto | Passive reader (`~/.omp/agent/sessions/**/*.jsonl`) |
159
159
  | **CodeBuddy** (Tencent) | ✅ Auto | SessionEnd hook in `~/.codebuddy/settings.json` (Claude-Code fork) |
160
+ | **Grok Build** (xAI) | ✅ Auto | SessionEnd hook + passive `signals.json` scan (`~/.grok/sessions/**/signals.json`) |
160
161
  | **Kilo CLI** (kilo.ai) | ✅ Auto | Passive SQLite reader (`~/.local/share/kilo/kilo.db`, OpenCode-fork schema) |
161
162
  | **Kilo Code** (VS Code extension) | ✅ Auto | Passive `ui_messages.json` reader (Cursor/Code/CodeBuddy/Windsurf globalStorage) |
162
163
 
163
164
  > **Do I need to install any plugin or hook manually?** No. `tokentracker` (or `tokentracker init`) handles everything on first run:
164
- > - **Hook-based** tools (Claude Code, Codex, Gemini, Every Code, **CodeBuddy**) — we write a SessionEnd hook or TOML notify entry into the tool's own config.
165
+ > - **Hook-based** tools (Claude Code, Codex, Gemini, Every Code, **CodeBuddy**, **Grok Build**) — we write a SessionEnd hook or TOML notify entry into the tool's own config.
165
166
  > - **Plugin-based** tools (OpenCode, **OpenClaw**) — the plugin ships inside the npm package (`~/.tokentracker/app/openclaw-plugin/`). We link it via the tool's own CLI (`openclaw plugins install --link …` + `enable`). No download, no drag-and-drop.
166
- > - **Passive readers** (Cursor, Kiro, Hermes, Kimi Code, Copilot, **oh-my-pi**, **Kilo CLI**, **Kilo Code**) — nothing is installed into those tools. We only read files they already produce (SQLite DB, JSONL, OTEL export).
167
+ > - **Passive readers** (Cursor, Kiro, Hermes, Kimi Code, Copilot, **Grok Build**, **oh-my-pi**, **Kilo CLI**, **Kilo Code**) — nothing is installed into those tools. We only read files they already produce (SQLite DB, JSONL, OTEL export).
168
+ > - **Grok Build estimate** — current `signals.json` data exposes `contextTokensUsed` snapshots, so TokenTracker estimates Grok usage and cost until per-call telemetry is available.
167
169
  >
168
170
  > Run `tokentracker status` anytime to verify every integration's state. If something shows `skipped`, the `detail` column explains why (e.g. tool CLI not on `PATH`, config unreadable).
169
171
  >
@@ -189,7 +191,7 @@ Missing your tool? [Open an issue](https://github.com/mm7894215/TokenTracker/iss
189
191
 
190
192
  ```mermaid
191
193
  flowchart LR
192
- A["AI CLI Tools<br/>Claude · Codex · Cursor · Gemini · Kiro<br/>OpenCode · OpenClaw · Every Code · Hermes · Copilot · Kimi Code · CodeBuddy · oh-my-pi"]
194
+ A["AI CLI Tools<br/>Claude · Codex · Cursor · Gemini · Kiro<br/>OpenCode · OpenClaw · Every Code · Hermes · Copilot · Kimi Code · CodeBuddy · Grok Build · oh-my-pi"]
193
195
  A -->|hooks trigger| B[Token Tracker]
194
196
  B -->|parse logs<br/>30-min UTC buckets| C[(Local SQLite)]
195
197
  C --> D[Web Dashboard]
package/README.zh-CN.md CHANGED
@@ -78,7 +78,7 @@ brew install mm7894215/tokentracker/tokentracker
78
78
 
79
79
  ## ✨ 特性
80
80
 
81
- - 🔌 **开箱即用支持 13 款 AI 工具** —— Claude Code、Codex CLI、Cursor、Gemini CLI、Kiro、OpenCode、OpenClaw、Every Code、Hermes Agent、GitHub Copilot、Kimi Code、CodeBuddy、oh-my-pi
81
+ - 🔌 **开箱即用支持 14 款 AI 工具** —— Claude Code、Codex CLI、Cursor、Gemini CLI、Kiro、OpenCode、OpenClaw、Every Code、Hermes Agent、GitHub Copilot、Kimi Code、CodeBuddy、Grok Build、oh-my-pi
82
82
  - 🧩 **Skills 管理器** —— 浏览 250+ 公开 skill(来自 `anthropics/skills`、`ComposioHQ/awesome-claude-skills`、`skills.sh` 以及你自己添加的任何 GitHub 仓库),一次安装,同步到 Claude / Codex / Gemini / OpenCode / Hermes,每个 Agent 单独开关,一键撤销
83
83
  - 🏠 **100% 本地** —— Token 数据绝不离开你的机器。无账号、无 API Key
84
84
  - 🚀 **零配置** —— 首次运行自动安装所有 hook。30 秒从零到 Dashboard
@@ -157,11 +157,13 @@ brew install mm7894215/tokentracker/tokentracker
157
157
  | **Kimi Code** | ✅ 自动 | 被动读取 `wire.jsonl`(`~/.kimi/sessions/**/wire.jsonl`) |
158
158
  | **oh-my-pi (Pi Coding Agent)** | ✅ 自动 | 被动读取(`~/.omp/agent/sessions/**/*.jsonl`) |
159
159
  | **CodeBuddy** (腾讯) | ✅ 自动 | 写入 `~/.codebuddy/settings.json` 的 SessionEnd hook(Claude-Code fork) |
160
+ | **Grok Build** (xAI) | ✅ 自动 | SessionEnd hook + 被动扫描 `signals.json`(`~/.grok/sessions/**/signals.json`) |
160
161
 
161
162
  > **需要手动装什么插件 / hook 吗?** 不需要。`tokentracker`(或 `tokentracker init`)第一次跑的时候会全部搞定:
162
- > - **基于 hook 的工具**(Claude Code、Codex、Gemini、Every Code)—— 我们把 SessionEnd hook 或 TOML notify 条目写入它们自己的配置文件
163
+ > - **基于 hook 的工具**(Claude Code、Codex、Gemini、Every Code、**CodeBuddy**、**Grok Build**)—— 我们把 SessionEnd hook 或 TOML notify 条目写入它们自己的配置文件
163
164
  > - **基于插件的工具**(OpenCode、**OpenClaw**)—— 插件随 npm 包一起分发(`~/.tokentracker/app/openclaw-plugin/`),通过对应工具自己的 CLI 挂接(`openclaw plugins install --link …` + `enable`)。无需下载、无需拖拽
164
- > - **被动读取类**(Cursor、Kiro、Hermes、Kimi Code、Copilot、**oh-my-pi**)—— 完全不往它们里面塞东西,只读取它们自己产生的文件(SQLite DB、JSONL、OTEL 导出)
165
+ > - **被动读取类**(Cursor、Kiro、Hermes、Kimi Code、Copilot、**Grok Build**、**oh-my-pi**)—— 完全不往它们里面塞东西,只读取它们自己产生的文件(SQLite DB、JSONL、OTEL 导出)
166
+ > - **Grok Build 估算说明** —— Grok 当前的 `signals.json` 暴露的是 `contextTokensUsed` 快照,所以在 Grok 提供按调用粒度的遥测之前,TokenTracker 对 Grok 的用量与成本是估算值
165
167
  >
166
168
  > 任何时候都可以用 `tokentracker status` 查看每个集成的状态。如果显示 `skipped`,`detail` 列会解释原因(例如某工具 CLI 不在 `PATH` 上、config 不可读等)。
167
169
  >
@@ -175,7 +177,7 @@ brew install mm7894215/tokentracker/tokentracker
175
177
 
176
178
  | | **TokenTracker** | ccusage | Cursor 自带统计 |
177
179
  |--------------------------|:---:|:---:|:---:|
178
- | **支持的 AI 工具数** | **13** | 1(Claude) | 1(Cursor) |
180
+ | **支持的 AI 工具数** | **14** | 1(Claude) | 1(Cursor) |
179
181
  | **本地优先,无需账号** | ✅ | ✅ | ❌ |
180
182
  | **原生菜单栏 App** | ✅ | ❌ | ❌ |
181
183
  | **桌面小组件** | ✅ 4 个小组件 | ❌ | ❌ |
@@ -187,7 +189,7 @@ brew install mm7894215/tokentracker/tokentracker
187
189
 
188
190
  ```mermaid
189
191
  flowchart LR
190
- A["AI CLI 工具<br/>Claude · Codex · Cursor · Gemini · Kiro<br/>OpenCode · OpenClaw · Every Code · Hermes · Copilot · Kimi Code · CodeBuddy · oh-my-pi"]
192
+ A["AI CLI 工具<br/>Claude · Codex · Cursor · Gemini · Kiro<br/>OpenCode · OpenClaw · Every Code · Hermes · Copilot · Kimi Code · CodeBuddy · Grok Build · oh-my-pi"]
191
193
  A -->|hook 触发| B[Token Tracker]
192
194
  B -->|解析日志<br/>30 分钟 UTC 桶| C[(本地 SQLite)]
193
195
  C --> D[Web Dashboard]