claude-quota-bar 0.3.3 → 0.5.0

package/README.md

@@ -1,13 +1,16 @@
 # claude-quota-bar
 
 Fast Rust statusline for [Claude Code](https://github.com/anthropics/claude-code).
-Battery-style 5-hour / 7-day quota bars, context-window indicator, prompt-cache
-state, and `dir:branch *N` — at ~2.5ms cold start and a ~0.5MB binary.
+Battery-style 5-hour / 7-day quota bars, context-window indicator, session
+active time, and `dir:branch *N` — at ~2.5ms cold start and a ~0.5MB binary.
 
 ```
-5h[███42%░░░░]⏰26m | 7d[███35%░░░░]⏰8d3h | Opus 4.7(71.0k/1.0M) | cache 4m12s | proj:main *3
+5h[███42%░░░░]⏰26m | 7d[███35%░░░░]⏰8d3h | Opus 4.7(71.0k/1.0M) | ⏱2h15m | proj:main *3
 ```
 
+Requires Claude Code ≥ 2.1.132 (where `context_window.total_input_tokens`
+reports the current context occupancy rather than a cumulative session total).
+
 ## Why this and not the Python ones
 
 - **Speed.** Claude Code renders statusLine on every prompt. Python is ~50ms cold
@@ -44,16 +47,34 @@ Then wire it into Claude Code (`~/.claude/settings.json`):
 
 ## Segments
 
-Default layout: `5h,7d,model,cache,dir`.
+Default layout: `5h,7d,model,session,dir`.
 
 | Segment | Source | What it shows |
 |---------|--------|---------------|
 | `5h`    | `rate_limits.five_hour` | Battery bar with `%` inside, plus `⏰` countdown to reset |
 | `7d`    | `rate_limits.seven_day` | Same, weekly window |
 | `model` | `model` + `context_window` | `Opus 4.7(71.0k/1.0M)` — model + ctx tokens used / window |
-| `cache` | transcript scan | Time left on the prompt cache (`4m12s`), or `COLD` once it has expired |
+| `session` | own ledger per `session_id` | `⏱2h15m` — active time this session, idle gaps excluded |
 | `dir`   | `workspace.current_dir` + git | `proj:main *3 ↑1 ↓2` — dir, branch, dirty count, ahead/behind |
 
+### How `session` counts time
+
+Claude Code's own `cost.total_duration_ms` is wall-clock since process start:
+it keeps growing while you're at lunch and resets to zero on `--resume`.
+Instead, this bar keeps its own per-session ledger
+(`~/.cache/claude-quota-bar/sessions/<session_id>.json`), treating each
+statusline render as a heartbeat:
+
+- Gaps **≤ 15 minutes** between renders count as active time (think-time,
+  long builds). Longer gaps are interruptions and are dropped.
+- A render only accrues when the payload shows progress
+  (`total_api_duration_ms` changed), so `statusLine.refreshInterval` users
+  don't accumulate idle wall-clock.
+- `--resume` / `--continue` keep their session_id, so the counter picks up
+  where it left off. `--fork-session` / `/branch` get a fresh counter.
+
+Ledgers untouched for 7 days are swept automatically.
+
 When Anthropic hasn't yet shipped `rate_limits` (first few renders of a fresh
 session), the bar displays `--%`. A cross-session cache at
 `~/.cache/claude-quota-bar/last_stdin.json` restores the most recent values, so
@@ -65,8 +86,7 @@ Configured via environment variables:
 
 | Variable | Default | Meaning |
 |----------|---------|---------|
-| `STATUSLINE_LAYOUT` | `5h,7d,model,cache,dir` | Comma-separated segment names (order matters) |
-| `STATUSLINE_CACHE_TTL` | `3600` | Prompt-cache lifetime in seconds. The default assumes the 1-hour extended cache that Claude.ai Pro/Max accounts get automatically; set `300` for the standard 5-minute cache. The active TTL isn't exposed to the statusline, so it can't be auto-detected. |
+| `STATUSLINE_LAYOUT` | `5h,7d,model,session,dir` | Comma-separated segment names (order matters) |
 | `NO_COLOR` | unset | If set, strips all ANSI — falls back to `█`/`░` glyphs |
 
 Severity thresholds (green / yellow / red) flip at 30% and 70% quota used.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-quota-bar",
-  "version": "0.3.3",
-  "description": "Fast Rust statusline for Claude Code — battery-bar 5h/7d quota, ctx, cache age, git",
+  "version": "0.5.0",
+  "description": "Fast Rust statusline for Claude Code — battery-bar 5h/7d quota, ctx, git",
   "keywords": [
     "claude",
     "statusline",
@@ -29,12 +29,12 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "claude-quota-bar-darwin-arm64": "0.3.3",
-    "claude-quota-bar-darwin-x64": "0.3.3",
-    "claude-quota-bar-linux-x64": "0.3.3",
-    "claude-quota-bar-linux-x64-musl": "0.3.3",
-    "claude-quota-bar-linux-arm64": "0.3.3",
-    "claude-quota-bar-linux-arm64-musl": "0.3.3",
-    "claude-quota-bar-win32-x64": "0.3.3"
+    "claude-quota-bar-darwin-arm64": "0.5.0",
+    "claude-quota-bar-darwin-x64": "0.5.0",
+    "claude-quota-bar-linux-x64": "0.5.0",
+    "claude-quota-bar-linux-x64-musl": "0.5.0",
+    "claude-quota-bar-linux-arm64": "0.5.0",
+    "claude-quota-bar-linux-arm64-musl": "0.5.0",
+    "claude-quota-bar-win32-x64": "0.5.0"
   }
 }