@mai0313/vibe-coding-tracker 2.2.2 → 2.2.3

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.
Files changed (10) hide show
  1. package/README.md +14 -12
  2. package/README.zh-CN.md +14 -12
  3. package/README.zh-TW.md +14 -12
  4. package/binaries/linux-arm64-gnu/vibe_coding_tracker +0 -0
  5. package/binaries/linux-x64-gnu/vibe_coding_tracker +0 -0
  6. package/binaries/macos-arm64/vibe_coding_tracker +0 -0
  7. package/binaries/macos-x64/vibe_coding_tracker +0 -0
  8. package/binaries/windows-arm64/vibe_coding_tracker.exe +0 -0
  9. package/binaries/windows-x64/vibe_coding_tracker.exe +0 -0
  10. package/package.json +1 -1
package/README.md CHANGED
@@ -2,8 +2,8 @@
2
2
 
3
3
  # Vibe Coding Tracker — AI Coding Assistant Usage Tracker
4
4
 
5
- [![Crates.io](https://img.shields.io/crates/v/vibe_coding_tracker?logo=rust&style=flat-square&color=E05D44)](https://crates.io/crates/vibe_coding_tracker)
6
- [![Crates.io Downloads](https://img.shields.io/crates/d/vibe_coding_tracker?logo=rust&style=flat-square)](https://crates.io/crates/vibe_coding_tracker)
5
+ [![Crates.io](https://img.shields.io/crates/v/vct-cli?logo=rust&style=flat-square&color=E05D44)](https://crates.io/crates/vct-cli)
6
+ [![Crates.io Downloads](https://img.shields.io/crates/d/vct-cli?logo=rust&style=flat-square)](https://crates.io/crates/vct-cli)
7
7
  [![npm version](https://img.shields.io/npm/v/vibe-coding-tracker?logo=npm&style=flat-square&color=CB3837)](https://www.npmjs.com/package/vibe-coding-tracker)
8
8
  [![npm downloads](https://img.shields.io/npm/dt/vibe-coding-tracker?logo=npm&style=flat-square)](https://www.npmjs.com/package/vibe-coding-tracker)
9
9
  [![PyPI version](https://img.shields.io/pypi/v/vibe_coding_tracker?logo=python&style=flat-square&color=3776AB)](https://pypi.org/project/vibe_coding_tracker/)
@@ -117,7 +117,7 @@ uvx vibe_coding_tracker usage
117
117
  Install using Cargo from the official Rust package registry:
118
118
 
119
119
  ```bash
120
- cargo install vibe_coding_tracker
120
+ cargo install vct-cli
121
121
  ```
122
122
 
123
123
  ### First Run
@@ -148,7 +148,7 @@ Commands:
148
148
  usage Display token usage statistics
149
149
  version Display version information
150
150
  update Update to the latest version from GitHub releases
151
- fetch Fetch a provider's raw quota/usage API response
151
+ quota Fetch a provider's raw quota/usage API response
152
152
  config Show or edit the persistent settings file (~/.vct/config.toml)
153
153
  help Print this message or the help of the given subcommand(s)
154
154
  ```
@@ -298,7 +298,7 @@ The tool automatically scans these directories:
298
298
  - `~/.hermes/state.db` (Hermes — SQLite database, honors `$HERMES_HOME`; `usage` only)
299
299
  - `$GROK_HOME/sessions/*/*/signals.json` (Grok CLI — defaults to `~/.grok`; sibling `updates.jsonl` supplies `analysis` data)
300
300
 
301
- Grok `usage` is one point-in-time local context estimate: vct records `signals.json`'s `contextTokensUsed` as cache-read tokens and estimates cost at the model's cache-read price. It is not cumulative billed usage. `analysis` reconstructs completed Read / Write / Edit / Bash / TodoWrite operations from the sibling `updates.jsonl`. Grok does not support quota panels or `vct fetch`.
301
+ Grok `usage` is one point-in-time local context estimate: vct records `signals.json`'s `contextTokensUsed` as cache-read tokens and estimates cost at the model's cache-read price. It is not cumulative billed usage. `analysis` reconstructs completed Read / Write / Edit / Bash / TodoWrite operations from the sibling `updates.jsonl`. Grok does not support quota panels or `vct quota`.
302
302
 
303
303
  For noninteractive `usage` and `analysis` scans, vct exits with an error when every discovered source fails. If only some sources fail, it keeps the successful results and prints one diagnostic summary to stderr. The TUI stays best-effort and preserves its last successful payload instead.
304
304
 
@@ -509,12 +509,14 @@ The binary version is produced at build time by `build.rs` from `git describe`,
509
509
 
510
510
  ---
511
511
 
512
- ## Fetch Command
512
+ ## Quota Command
513
513
 
514
514
  **Print a provider's raw quota/usage API response — no parsing, no aggregation.**
515
515
 
516
516
  Calls the same quota endpoint the `usage` dashboard uses (Claude / Codex / Copilot / Cursor) exactly once and prints the raw body, so you can inspect the exact API shape or sanity-check your credentials. It reads each provider's stored credentials and does **not** refresh tokens: if a token is expired, re-auth with that provider's own CLI (`claude` / `codex` / `copilot` / `cursor-agent`).
517
517
 
518
+ > The previous name `vct fetch` is kept as a hidden alias, so existing scripts keep working.
519
+
518
520
  ### Flags
519
521
 
520
522
  | Flag | Purpose |
@@ -528,16 +530,16 @@ Calls the same quota endpoint the `usage` dashboard uses (Claude / Codex / Copil
528
530
 
529
531
  ```bash
530
532
  # Raw JSON (default)
531
- vct fetch claude
532
- vct fetch codex
533
- vct fetch copilot
534
- vct fetch cursor
533
+ vct quota claude
534
+ vct quota codex
535
+ vct quota copilot
536
+ vct quota cursor
535
537
 
536
538
  # Flattened plain text
537
- vct fetch codex --text
539
+ vct quota codex --text
538
540
 
539
541
  # Flattened key/value table
540
- vct fetch copilot --table
542
+ vct quota copilot --table
541
543
  ```
542
544
 
543
545
  > [!NOTE]
package/README.zh-CN.md CHANGED
@@ -2,8 +2,8 @@
2
2
 
3
3
  # Vibe Coding Tracker — AI 编程助手使用量追踪器
4
4
 
5
- [![Crates.io](https://img.shields.io/crates/v/vibe_coding_tracker?logo=rust&style=flat-square&color=E05D44)](https://crates.io/crates/vibe_coding_tracker)
6
- [![Crates.io Downloads](https://img.shields.io/crates/d/vibe_coding_tracker?logo=rust&style=flat-square)](https://crates.io/crates/vibe_coding_tracker)
5
+ [![Crates.io](https://img.shields.io/crates/v/vct-cli?logo=rust&style=flat-square&color=E05D44)](https://crates.io/crates/vct-cli)
6
+ [![Crates.io Downloads](https://img.shields.io/crates/d/vct-cli?logo=rust&style=flat-square)](https://crates.io/crates/vct-cli)
7
7
  [![npm version](https://img.shields.io/npm/v/vibe-coding-tracker?logo=npm&style=flat-square&color=CB3837)](https://www.npmjs.com/package/vibe-coding-tracker)
8
8
  [![npm downloads](https://img.shields.io/npm/dt/vibe-coding-tracker?logo=npm&style=flat-square)](https://www.npmjs.com/package/vibe-coding-tracker)
9
9
  [![PyPI version](https://img.shields.io/pypi/v/vibe_coding_tracker?logo=python&style=flat-square&color=3776AB)](https://pypi.org/project/vibe_coding_tracker/)
@@ -117,7 +117,7 @@ uvx vibe_coding_tracker usage
117
117
  使用 Cargo 从 Rust 官方包注册中心安装：
118
118
 
119
119
  ```bash
120
- cargo install vibe_coding_tracker
120
+ cargo install vct-cli
121
121
  ```
122
122
 
123
123
  ### 首次运行
@@ -148,7 +148,7 @@ Commands:
148
148
  usage Display token usage statistics
149
149
  version Display version information
150
150
  update Update to the latest version from GitHub releases
151
- fetch Fetch a provider's raw quota/usage API response
151
+ quota Fetch a provider's raw quota/usage API response
152
152
  config Show or edit the persistent settings file (~/.vct/config.toml)
153
153
  help Print this message or the help of the given subcommand(s)
154
154
  ```
@@ -298,7 +298,7 @@ Totals (by Provider)
298
298
  - `~/.hermes/state.db`（Hermes，SQLite 数据库，遵循 `$HERMES_HOME`；仅 `usage`）
299
299
  - `$GROK_HOME/sessions/*/*/signals.json`（Grok CLI，默认使用 `~/.grok`；同层的 `updates.jsonl` 提供 `analysis` 数据）
300
300
 
301
- Grok 的 `usage` 是单一时点的本地 context 估算：vct 会把 `signals.json` 的 `contextTokensUsed` 记为 cache-read token，并按该 model 的 cache-read 费率估算费用。这不是累计的 billed usage。`analysis` 会从同层的 `updates.jsonl` 还原已完成的 Read / Write / Edit / Bash / TodoWrite 操作。Grok 不支持 quota panel 或 `vct fetch`。
301
+ Grok 的 `usage` 是单一时点的本地 context 估算：vct 会把 `signals.json` 的 `contextTokensUsed` 记为 cache-read token，并按该 model 的 cache-read 费率估算费用。这不是累计的 billed usage。`analysis` 会从同层的 `updates.jsonl` 还原已完成的 Read / Write / Edit / Bash / TodoWrite 操作。Grok 不支持 quota panel 或 `vct quota`。
302
302
 
303
303
  对于非交互式 `usage` 与 `analysis` 扫描, 如果所有找到的 source 都失败, vct 会以错误结束. 如果只有部分 source 失败, vct 会保留成功的结果, 并向 stderr 打印一则诊断摘要. TUI 则保持 best-effort, 并保留上一次成功的 payload.
304
304
 
@@ -509,12 +509,14 @@ Binary version 由 `build.rs` 在编译期通过 `git describe` 写入，开发
509
509
 
510
510
  ---
511
511
 
512
- ## Fetch 命令
512
+ ## Quota 命令
513
513
 
514
514
  **打印某个供应商的原始 quota/usage API 响应 — 不解析、不聚合。**
515
515
 
516
516
  对 `usage` 面板使用的同一个 quota 端点（Claude / Codex / Copilot / Cursor）发一次请求，直接打印原始 body，方便你查看 API 的实际结构或检查凭证是否正常。它读取各供应商已保存的凭证，并且**不会**刷新 token：token 过期时，请用对应供应商自己的 CLI 重新登录（`claude` / `codex` / `copilot` / `cursor-agent`）。
517
517
 
518
+ > 旧名称 `vct fetch` 保留为隐藏别名，现有脚本仍可继续使用。
519
+
518
520
  ### 参数
519
521
 
520
522
  | 参数 | 用途 |
@@ -528,16 +530,16 @@ Binary version 由 `build.rs` 在编译期通过 `git describe` 写入，开发
528
530
 
529
531
  ```bash
530
532
  # 原始 JSON（默认）
531
- vct fetch claude
532
- vct fetch codex
533
- vct fetch copilot
534
- vct fetch cursor
533
+ vct quota claude
534
+ vct quota codex
535
+ vct quota copilot
536
+ vct quota cursor
535
537
 
536
538
  # 摊平成纯文本
537
- vct fetch codex --text
539
+ vct quota codex --text
538
540
 
539
541
  # 摊平成 key/value 表格
540
- vct fetch copilot --table
542
+ vct quota copilot --table
541
543
  ```
542
544
 
543
545
  > [!NOTE]
package/README.zh-TW.md CHANGED
@@ -2,8 +2,8 @@
2
2
 
3
3
  # Vibe Coding Tracker — AI 程式設計助手使用量追蹤器
4
4
 
5
- [![Crates.io](https://img.shields.io/crates/v/vibe_coding_tracker?logo=rust&style=flat-square&color=E05D44)](https://crates.io/crates/vibe_coding_tracker)
6
- [![Crates.io Downloads](https://img.shields.io/crates/d/vibe_coding_tracker?logo=rust&style=flat-square)](https://crates.io/crates/vibe_coding_tracker)
5
+ [![Crates.io](https://img.shields.io/crates/v/vct-cli?logo=rust&style=flat-square&color=E05D44)](https://crates.io/crates/vct-cli)
6
+ [![Crates.io Downloads](https://img.shields.io/crates/d/vct-cli?logo=rust&style=flat-square)](https://crates.io/crates/vct-cli)
7
7
  [![npm version](https://img.shields.io/npm/v/vibe-coding-tracker?logo=npm&style=flat-square&color=CB3837)](https://www.npmjs.com/package/vibe-coding-tracker)
8
8
  [![npm downloads](https://img.shields.io/npm/dt/vibe-coding-tracker?logo=npm&style=flat-square)](https://www.npmjs.com/package/vibe-coding-tracker)
9
9
  [![PyPI version](https://img.shields.io/pypi/v/vibe_coding_tracker?logo=python&style=flat-square&color=3776AB)](https://pypi.org/project/vibe_coding_tracker/)
@@ -117,7 +117,7 @@ uvx vibe_coding_tracker usage
117
117
  使用 Cargo 從官方 Rust 套件倉庫安裝：
118
118
 
119
119
  ```bash
120
- cargo install vibe_coding_tracker
120
+ cargo install vct-cli
121
121
  ```
122
122
 
123
123
  ### 首次執行
@@ -148,7 +148,7 @@ Commands:
148
148
  usage Display token usage statistics
149
149
  version Display version information
150
150
  update Update to the latest version from GitHub releases
151
- fetch Fetch a provider's raw quota/usage API response
151
+ quota Fetch a provider's raw quota/usage API response
152
152
  config Show or edit the persistent settings file (~/.vct/config.toml)
153
153
  help Print this message or the help of the given subcommand(s)
154
154
  ```
@@ -298,7 +298,7 @@ Totals (by Provider)
298
298
  - `~/.hermes/state.db`（Hermes，SQLite 資料庫，遵循 `$HERMES_HOME`；僅 `usage`）
299
299
  - `$GROK_HOME/sessions/*/*/signals.json`（Grok CLI，預設使用 `~/.grok`；同層的 `updates.jsonl` 提供 `analysis` 資料）
300
300
 
301
- Grok 的 `usage` 是單一當下的本地 context 估算：vct 會把 `signals.json` 的 `contextTokensUsed` 記為 cache-read token，並以該 model 的 cache-read 費率估算費用。這不是累計的 billed usage。`analysis` 會從同層的 `updates.jsonl` 還原已完成的 Read / Write / Edit / Bash / TodoWrite 操作。Grok 不支援 quota panel 或 `vct fetch`。
301
+ Grok 的 `usage` 是單一當下的本地 context 估算：vct 會把 `signals.json` 的 `contextTokensUsed` 記為 cache-read token，並以該 model 的 cache-read 費率估算費用。這不是累計的 billed usage。`analysis` 會從同層的 `updates.jsonl` 還原已完成的 Read / Write / Edit / Bash / TodoWrite 操作。Grok 不支援 quota panel 或 `vct quota`。
302
302
 
303
303
  對於非互動式 `usage` 與 `analysis` 掃描, 如果所有找到的 source 都失敗, vct 會回傳錯誤. 如果只有部分 source 失敗, vct 會保留成功的結果, 並向 stderr 印出一則診斷摘要. TUI 則保持 best-effort, 並保留上一次成功的 payload.
304
304
 
@@ -509,12 +509,14 @@ Binary version 由 `build.rs` 在編譯期透過 `git describe` 寫入，開發
509
509
 
510
510
  ---
511
511
 
512
- ## Fetch 指令
512
+ ## Quota 指令
513
513
 
514
514
  **印出某個供應商的原始 quota/usage API 回應 — 不解析、不彙整。**
515
515
 
516
516
  對 `usage` 面板使用的同一個 quota 端點（Claude / Codex / Copilot / Cursor）發一次請求，直接印出原始 body，方便你檢視 API 的實際結構或確認憑證是否正常。它讀取各供應商已儲存的憑證，而且**不會**刷新 token：token 過期時，請用對應供應商自己的 CLI 重新登入（`claude` / `codex` / `copilot` / `cursor-agent`）。
517
517
 
518
+ > 舊名稱 `vct fetch` 保留為隱藏別名，現有 script 仍可繼續使用。
519
+
518
520
  ### 參數
519
521
 
520
522
  | 參數 | 用途 |
@@ -528,16 +530,16 @@ Binary version 由 `build.rs` 在編譯期透過 `git describe` 寫入，開發
528
530
 
529
531
  ```bash
530
532
  # 原始 JSON（預設）
531
- vct fetch claude
532
- vct fetch codex
533
- vct fetch copilot
534
- vct fetch cursor
533
+ vct quota claude
534
+ vct quota codex
535
+ vct quota copilot
536
+ vct quota cursor
535
537
 
536
538
  # 攤平成純文字
537
- vct fetch codex --text
539
+ vct quota codex --text
538
540
 
539
541
  # 攤平成 key/value 表格
540
- vct fetch copilot --table
542
+ vct quota copilot --table
541
543
  ```
542
544
 
543
545
  > [!NOTE]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mai0313/vibe-coding-tracker",
3
- "version": "2.2.2",
3
+ "version": "2.2.3",
4
4
  "description": "Vibe Coding Tracker - AI coding assistant telemetry/usage parser, aggregate JSONL events into CodeAnalysis results",
5
5
  "author": "Wei Lee <mai@mai0313.com>",
6
6
  "license": "MIT",