vibe-coding-tracker 0.17.0__tar.gz → 1.1.0__tar.gz

{vibe_coding_tracker-0.17.0 → vibe_coding_tracker-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: vibe-coding-tracker
-Version: 0.17.0
+Version: 1.1.0
 Summary: Vibe Coding Tracker - AI coding assistant telemetry/usage parser, aggregate JSONL events into CodeAnalysis results
 Keywords: cli,ai,coding-assistant,telemetry,claude,codex,gemini,usage-tracker,analytics
 Author: Wei Lee
@@ -169,7 +169,6 @@ vct <COMMAND> [OPTIONS]
 Commands:
   analysis    Analyze JSONL conversation files (single file or all sessions)
   usage       Display token usage statistics
-  statusline  Cache Claude Code rate limits from a statusLine hook (stdin JSON)
   version     Display version information
   update      Update to the latest version from GitHub releases
   help        Print this message or the help of the given subcommand(s)
@@ -262,21 +261,27 @@ The tool automatically scans these directories:
 
 ### Live Quota Panels
 
-At the bottom of the interactive dashboard, the per-provider stats sit on the left and two live quota panels sit on the right:
+`vct usage` shows **live remaining quota for Claude Code and Codex right in the dashboard — with zero setup.** No status-line hook, no config file: vct reads each provider's own OAuth credentials, calls its usage API on a background thread, and keeps the panels current while you work.
 
 ```
-┌ Provider/Tokens/Cost/Days ┬ Claude ────────┬ Codex ──────────┐
-│ Claude    1.2M  $3.00  4d │ 5h ▰▰▱▱▱  16%  │ Plan: plus      │
-│ Codex      800K $0.00  6d │    ↻ 4h13m     │ 5h ▰▰▱▱▱  27%   │
-│ ...                       │ 7d ▰▰▰▱▱  28%  │ 7d ▱▱▱▱▱   4%   │
-│                           │ updated 2m ago │ Credits: 0  +2  │
-└───────────────────────────┴────────────────┴─────────────────┘
+┌ Provider/Tokens/Cost/Days ┬ Claude ───────────────────┬ Codex ────────────────────┐
+│ Claude    1.2M  $3.00  4d │ Plan: max 20x              │ Plan: plus                 │
+│ Codex      800K $0.00  6d │ 5h     ▰▱▱▱▱  16%  ↻ 2h0m  │ 5h     ▰▰▱▱▱  37%  ↻ 2h33m │
+│ ...                       │ 7d     ▰▰▱▱▱  41%  ↻ 5d    │ 7d     ▰▰▱▱▱  24%  ↻ 3d16h │
+│                           │ Opus   ▰▰▰▱▱  61%  ↻ 5d    │ Credits: 0  +3 reset       │
+│                           │ Balance: -    $0.00 used   │ updated just now           │
+│                           │ updated just now           │                            │
+└───────────────────────────┴────────────────────────────┴────────────────────────────┘
 ```
 
-- **Claude** — 5-hour and weekly rate-limit usage. Claude Code only exposes these limits through its `statusLine` hook, so wire `vct statusline ingest` into your statusLine (see [Statusline Command](#statusline-command)) for this panel to populate.
-- **Codex** — plan tier, 5-hour and weekly usage, and credit balance. Pulled live from the ChatGPT backend (`wham/usage`) using the token in `~/.codex/auth.json` on a background thread; when unavailable it falls back to the newest `rate_limits` in your Codex session logs (the title shows `(API)` vs `(session)`).
+- **Claude** — plan tier, 5-hour, weekly, and per-model weekly usage from the official OAuth usage API (`GET /api/oauth/usage`), read from `~/.claude/.credentials.json`, plus your credit balance. Polled about once a minute to stay under the endpoint's rate limit; a red `LIMIT` flag appears in the title when a cap is hit. The per-model weekly row is best-effort and simply hides when that scope is not returned.
+- **Codex** — plan tier, 5-hour and weekly usage, and credit balance from the ChatGPT backend (`wham/usage`) using `~/.codex/auth.json` (with approximate remaining messages / spend cap when applicable); falls back to the newest `rate_limits` in your Codex session logs when the API is unavailable (the title shows `Codex` vs `Codex (session)`).
 
-Quota panels appear only in the interactive TUI; `--table`, `--text`, and `--json` are unchanged.
+**Automatic token refresh.** For both providers, when a token is near expiry or rejected, vct refreshes it and writes the new token back to the provider's own credential file (in that CLI's exact format), so a token is reused across checks rather than refreshed every time. If a refresh cannot proceed, the panel shows a `run: <provider> auth login` hint instead of breaking.
+
+A panel appears only for a provider whose credentials are present. Quota panels appear only in the interactive TUI; `--table`, `--text`, and `--json` are unchanged.
+
+> **Platform note:** on macOS, Claude Code stores its OAuth credentials in the system Keychain rather than `~/.claude/.credentials.json`, so the Claude panel is not shown on macOS.
 
 ---
 
@@ -350,35 +355,6 @@ vct analysis --output today.json --daily
 
 ---
 
-## Statusline Command
-
-**Feed Claude Code rate limits into the `usage` dashboard.**
-
-Claude Code only exposes its 5-hour / weekly rate limits through the `statusLine` hook's stdin JSON, so `vct` captures them from there and caches them to `~/.vibe_coding_tracker/claude_rate_limits.json` for the Claude quota panel.
-
-### If you already have a statusLine
-
-Add one backgrounded line to your existing statusLine script. It has zero impact on your current display and is isolated, so a vct error can never disturb the statusLine:
-
-```bash
-printf '%s' "$input" | vct statusline ingest >/dev/null 2>&1 &
-```
-
-### If you do not have a statusLine yet
-
-Point Claude Code's `~/.claude/settings.json` straight at vct, which caches the limits and prints a compact one-line status:
-
-```json
-{
-  "statusLine": {
-    "type": "command",
-    "command": "vct statusline"
-  }
-}
-```
-
----
-
 ## Update Command
 
 **Keep your installation up-to-date automatically.**

{vibe_coding_tracker-0.17.0 → vibe_coding_tracker-1.1.0}/README.md

@@ -143,7 +143,6 @@ vct <COMMAND> [OPTIONS]
 Commands:
   analysis    Analyze JSONL conversation files (single file or all sessions)
   usage       Display token usage statistics
-  statusline  Cache Claude Code rate limits from a statusLine hook (stdin JSON)
   version     Display version information
   update      Update to the latest version from GitHub releases
   help        Print this message or the help of the given subcommand(s)
@@ -236,21 +235,27 @@ The tool automatically scans these directories:
 
 ### Live Quota Panels
 
-At the bottom of the interactive dashboard, the per-provider stats sit on the left and two live quota panels sit on the right:
+`vct usage` shows **live remaining quota for Claude Code and Codex right in the dashboard — with zero setup.** No status-line hook, no config file: vct reads each provider's own OAuth credentials, calls its usage API on a background thread, and keeps the panels current while you work.
 
 ```
-┌ Provider/Tokens/Cost/Days ┬ Claude ────────┬ Codex ──────────┐
-│ Claude    1.2M  $3.00  4d │ 5h ▰▰▱▱▱  16%  │ Plan: plus      │
-│ Codex      800K $0.00  6d │    ↻ 4h13m     │ 5h ▰▰▱▱▱  27%   │
-│ ...                       │ 7d ▰▰▰▱▱  28%  │ 7d ▱▱▱▱▱   4%   │
-│                           │ updated 2m ago │ Credits: 0  +2  │
-└───────────────────────────┴────────────────┴─────────────────┘
+┌ Provider/Tokens/Cost/Days ┬ Claude ───────────────────┬ Codex ────────────────────┐
+│ Claude    1.2M  $3.00  4d │ Plan: max 20x              │ Plan: plus                 │
+│ Codex      800K $0.00  6d │ 5h     ▰▱▱▱▱  16%  ↻ 2h0m  │ 5h     ▰▰▱▱▱  37%  ↻ 2h33m │
+│ ...                       │ 7d     ▰▰▱▱▱  41%  ↻ 5d    │ 7d     ▰▰▱▱▱  24%  ↻ 3d16h │
+│                           │ Opus   ▰▰▰▱▱  61%  ↻ 5d    │ Credits: 0  +3 reset       │
+│                           │ Balance: -    $0.00 used   │ updated just now           │
+│                           │ updated just now           │                            │
+└───────────────────────────┴────────────────────────────┴────────────────────────────┘
 ```
 
-- **Claude** — 5-hour and weekly rate-limit usage. Claude Code only exposes these limits through its `statusLine` hook, so wire `vct statusline ingest` into your statusLine (see [Statusline Command](#statusline-command)) for this panel to populate.
-- **Codex** — plan tier, 5-hour and weekly usage, and credit balance. Pulled live from the ChatGPT backend (`wham/usage`) using the token in `~/.codex/auth.json` on a background thread; when unavailable it falls back to the newest `rate_limits` in your Codex session logs (the title shows `(API)` vs `(session)`).
+- **Claude** — plan tier, 5-hour, weekly, and per-model weekly usage from the official OAuth usage API (`GET /api/oauth/usage`), read from `~/.claude/.credentials.json`, plus your credit balance. Polled about once a minute to stay under the endpoint's rate limit; a red `LIMIT` flag appears in the title when a cap is hit. The per-model weekly row is best-effort and simply hides when that scope is not returned.
+- **Codex** — plan tier, 5-hour and weekly usage, and credit balance from the ChatGPT backend (`wham/usage`) using `~/.codex/auth.json` (with approximate remaining messages / spend cap when applicable); falls back to the newest `rate_limits` in your Codex session logs when the API is unavailable (the title shows `Codex` vs `Codex (session)`).
 
-Quota panels appear only in the interactive TUI; `--table`, `--text`, and `--json` are unchanged.
+**Automatic token refresh.** For both providers, when a token is near expiry or rejected, vct refreshes it and writes the new token back to the provider's own credential file (in that CLI's exact format), so a token is reused across checks rather than refreshed every time. If a refresh cannot proceed, the panel shows a `run: <provider> auth login` hint instead of breaking.
+
+A panel appears only for a provider whose credentials are present. Quota panels appear only in the interactive TUI; `--table`, `--text`, and `--json` are unchanged.
+
+> **Platform note:** on macOS, Claude Code stores its OAuth credentials in the system Keychain rather than `~/.claude/.credentials.json`, so the Claude panel is not shown on macOS.
 
 ---
 
@@ -324,35 +329,6 @@ vct analysis --output today.json --daily
 
 ---
 
-## Statusline Command
-
-**Feed Claude Code rate limits into the `usage` dashboard.**
-
-Claude Code only exposes its 5-hour / weekly rate limits through the `statusLine` hook's stdin JSON, so `vct` captures them from there and caches them to `~/.vibe_coding_tracker/claude_rate_limits.json` for the Claude quota panel.
-
-### If you already have a statusLine
-
-Add one backgrounded line to your existing statusLine script. It has zero impact on your current display and is isolated, so a vct error can never disturb the statusLine:
-
-```bash
-printf '%s' "$input" | vct statusline ingest >/dev/null 2>&1 &
-```
-
-### If you do not have a statusLine yet
-
-Point Claude Code's `~/.claude/settings.json` straight at vct, which caches the limits and prints a compact one-line status:
-
-```json
-{
-  "statusLine": {
-    "type": "command",
-    "command": "vct statusline"
-  }
-}
-```
-
----
-
 ## Update Command
 
 **Keep your installation up-to-date automatically.**

{vibe_coding_tracker-0.17.0 → vibe_coding_tracker-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vibe_coding_tracker"
-version = "0.17.0"
+version = "1.1.0"
 description = "Vibe Coding Tracker - AI coding assistant telemetry/usage parser, aggregate JSONL events into CodeAnalysis results"
 authors = [
     { name = "Wei Lee", email = "mai@mai0313.com" }