@mai0313/vct 1.5.0 → 1.6.0

package/README.md

@@ -148,6 +148,7 @@ Commands:
   usage       Display token usage statistics
   version     Display version information
   update      Update to the latest version from GitHub releases
+  fetch       Fetch a provider's raw quota/usage API response
   help        Print this message or the help of the given subcommand(s)
 ```
 
@@ -470,6 +471,42 @@ The binary version is produced at build time by `build.rs` from `git describe`,
 
 ---
 
+## Fetch Command
+
+**Print a provider's raw quota/usage API response — no parsing, no aggregation.**
+
+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`).
+
+### Flags
+
+| Flag      | Purpose                                       |
+| --------- | --------------------------------------------- |
+| *(none)*  | Pretty JSON (default)                         |
+| `--json`  | Pretty JSON                                   |
+| `--text`  | Flattened `key: value` lines, script-friendly |
+| `--table` | Flattened Field / Value table                 |
+
+### Basic Usage
+
+```bash
+# Raw JSON (default)
+vct fetch claude
+vct fetch codex
+vct fetch copilot
+vct fetch cursor
+
+# Flattened plain text
+vct fetch codex --text
+
+# Flattened key/value table
+vct fetch copilot --table
+```
+
+> [!NOTE]
+> The response body is printed to stdout as-is. On an HTTP error the body is still printed and the process exits non-zero; a 401/403 additionally prints a `run: <cli> login` hint on stderr.
+
+---
+
 ## Smart Pricing System
 
 ### How It Works

package/README.zh-CN.md

@@ -148,6 +148,7 @@ Commands:
   usage       Display token usage statistics
   version     Display version information
   update      Update to the latest version from GitHub releases
+  fetch       Fetch a provider's raw quota/usage API response
   help        Print this message or the help of the given subcommand(s)
 ```
 
@@ -470,6 +471,42 @@ Binary version 由 `build.rs` 在编译期通过 `git describe` 写入，开发
 
 ---
 
+## Fetch 命令
+
+**打印某个供应商的原始 quota/usage API 响应 — 不解析、不聚合。**
+
+对 `usage` 面板使用的同一个 quota 端点（Claude / Codex / Copilot / Cursor）发一次请求，直接打印原始 body，方便你查看 API 的实际结构或检查凭证是否正常。它读取各供应商已保存的凭证，并且**不会**刷新 token：token 过期时，请用对应供应商自己的 CLI 重新登录（`claude` / `codex` / `copilot` / `cursor-agent`）。
+
+### 参数
+
+| 参数      | 用途                          |
+| --------- | ----------------------------- |
+| *(无)*    | 彩色 JSON（默认）             |
+| `--json`  | 彩色 JSON                     |
+| `--text`  | 摊平成 `key: value`，适合脚本 |
+| `--table` | 摊平成 Field / Value 表格     |
+
+### 基本用法
+
+```bash
+# 原始 JSON（默认）
+vct fetch claude
+vct fetch codex
+vct fetch copilot
+vct fetch cursor
+
+# 摊平成纯文本
+vct fetch codex --text
+
+# 摊平成 key/value 表格
+vct fetch copilot --table
+```
+
+> [!NOTE]
+> 响应 body 会原样打印到 stdout。遇到 HTTP 错误时仍会打印 body 并以非零状态退出；401/403 还会在 stderr 额外打印 `run: <cli> login` 提示。
+
+---
+
 ## 智能定价系统
 
 ### 工作原理

package/README.zh-TW.md

@@ -148,6 +148,7 @@ Commands:
   usage       Display token usage statistics
   version     Display version information
   update      Update to the latest version from GitHub releases
+  fetch       Fetch a provider's raw quota/usage API response
   help        Print this message or the help of the given subcommand(s)
 ```
 
@@ -470,6 +471,42 @@ Binary version 由 `build.rs` 在編譯期透過 `git describe` 寫入，開發
 
 ---
 
+## Fetch 指令
+
+**印出某個供應商的原始 quota/usage API 回應 — 不解析、不彙整。**
+
+對 `usage` 面板使用的同一個 quota 端點（Claude / Codex / Copilot / Cursor）發一次請求，直接印出原始 body，方便你檢視 API 的實際結構或確認憑證是否正常。它讀取各供應商已儲存的憑證，而且**不會**刷新 token：token 過期時，請用對應供應商自己的 CLI 重新登入（`claude` / `codex` / `copilot` / `cursor-agent`）。
+
+### 參數
+
+| 參數      | 用途                          |
+| --------- | ----------------------------- |
+| *(無)*    | 彩色 JSON（預設）             |
+| `--json`  | 彩色 JSON                     |
+| `--text`  | 攤平成 `key: value`，適合腳本 |
+| `--table` | 攤平成 Field / Value 表格     |
+
+### 基本用法
+
+```bash
+# 原始 JSON（預設）
+vct fetch claude
+vct fetch codex
+vct fetch copilot
+vct fetch cursor
+
+# 攤平成純文字
+vct fetch codex --text
+
+# 攤平成 key/value 表格
+vct fetch copilot --table
+```
+
+> [!NOTE]
+> 回應 body 會原樣印到 stdout。遇到 HTTP 錯誤時仍會印出 body 並以非零狀態結束；401/403 會在 stderr 額外印出 `run: <cli> login` 提示。
+
+---
+
 ## 智慧定價系統
 
 ### 運作方式

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mai0313/vct",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Vibe Coding Tracker - AI coding assistant telemetry/usage parser, aggregate JSONL events into CodeAnalysis results",
   "author": "Wei Lee <mai@mai0313.com>",
   "license": "MIT",