claude-doom-statusbar 0.3.0 → 0.4.0

package/README.md

@@ -1,9 +1,9 @@
 # claude-doom-statusbar
 
-A DOOM-inspired status bar for the [Claude Code](https://docs.claude.com/en/docs/claude-code) CLI. Your session, read off the Doomguy HUD: a mugshot whose face tracks your health, boxes for usage, model, project and system, and a live list of running subagents.
+A DOOM-inspired status bar for the [Claude Code](https://docs.claude.com/en/docs/claude-code) CLI. Your session, read off the Doomguy HUD: a mugshot whose face tracks your health, boxes for usage, model, project and system, and live lists of running agents and tasks.
 
 <p align="center">
-  <img src="assets/images/hud.png" alt="claude-doom-statusbar HUD: MODEL, USAGE, PROJECT, the DOOM mugshot, ACTIVITY, SUBAGENTS and SYS boxes">
+  <img src="assets/images/hud.png" alt="claude-doom-statusbar HUD: MODEL, USAGE, PROJECT, the DOOM mugshot, ACTIVITY, AGENTS, TASKS and SYS boxes">
 </p>
 
 The mugshot is the real DOOM (1993) status-face sprite, rasterised into the terminal at runtime — not ASCII art of it.
@@ -15,9 +15,10 @@ The HUD is a row of boxes centred on the mugshot. Each box is configurable; the
 - **mugshot** — the Doomguy face. Its HP (how bloodied it looks) follows your *usage headroom* — `min(5h, 7d) rate-limit room`, context as a fallback. It glances around when idle, winces on errors, snarls on writes, grins on a clean finish, dies when you're tapped out, and flashes invulnerable just after an advisor consult.
 - **MODEL** — model name + reasoning effort (a waxing-moon→sun icon), thinking/fast toggles, output style, and the configured `/advisor` model.
 - **USAGE** — context window (HP bar), the 5h / 7d rate-limit bars (with reset countdowns), RAM, session cost.
-- **PROJECT** — cwd, git branch, ahead/behind, dirty count, lines added/removed, PR state. The cwd, branch and PR are **clickable** (OSC 8 hyperlinks): Ctrl/Cmd-click to open the folder, the branch on the host, or the pull request.
-- **ACTIVITY** — a tool-activity "geiger" sparkline (duty-cycle over the last 30 s), running-subagent count, task progress, error count.
-- **SUBAGENTS** — a live list of running subagents (type/description + ticking runtime), always visible, widening to fit.
+- **PROJECT** — session name, cwd, git branch, a merged work line (changed files + ahead/behind), lines added/removed, PR state. The cwd, branch and PR are **clickable** (OSC 8 hyperlinks): Ctrl/Cmd-click to open the folder, the branch on the host, or the pull request. Long names are clipped to 24 chars so the box can't blow up.
+- **ACTIVITY** — a tool-activity "geiger" sparkline (duty-cycle over the last 30 s), running-agent count, task progress, error count.
+- **AGENTS** — a live list of running subagents (type/description + ticking runtime), always visible. Long lists scroll within the box height, with ↑/↓ markers counting the rows hidden off-screen.
+- **TASKS** — the session's todo list: settled items (✅ done, ❌ removed) on top, open items (⏩ in-progress, 🎯 pending) below. Scrolls like AGENTS, anchored on the open/settled boundary.
 - **SYS** — CPU, disk, session length, wall clock.
 
 Anything the session can't supply is hidden automatically, so the same config degrades cleanly.
@@ -54,32 +55,6 @@ npm i -g claude-doom-statusbar@latest    # global install
 npx claude-doom-statusbar@latest install
 ```
 
-### Manual wiring
-
-If you'd rather edit `~/.claude/settings.json` by hand, point it at the package's `src/` (use the absolute install path; on Windows use forward slashes):
-
-```json
-{
-  "env": { "DOOMBAR_PRESET": "/abs/path/claude-doom-statusbar/presets/full.toml", "FORCE_HYPERLINK": "1" },
-  "statusLine": {
-    "type": "command",
-    "command": "node \"/abs/path/claude-doom-statusbar/src/statusline.js\"",
-    "refreshInterval": 1
-  },
-  "hooks": {
-    "PreToolUse":         [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
-    "PostToolUse":        [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
-    "PostToolUseFailure": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
-    "Stop":               [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
-    "PermissionDenied":   [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
-    "SubagentStart":      [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
-    "SubagentStop":       [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
-    "TaskCreated":        [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
-    "TaskCompleted":      [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }]
-  }
-}
-```
-
 ### Clickable links
 
 The cwd / branch / PR are emitted as OSC 8 hyperlinks. They render in any terminal but only click in ones Claude Code detects as hyperlink-capable (iTerm2, kitty, WezTerm, …). **Windows Terminal isn't auto-detected** — launch with `FORCE_HYPERLINK=1` to enable them:
@@ -96,7 +71,7 @@ $env:FORCE_HYPERLINK = "1"; claude
 - **`default`** — balanced HUD.
 - **`full`** — every box, the look in the screenshot above.
 
-A preset is TOML: a `[bar]` style block, a `[mugshot]` block, and a list of `[[segment]]` boxes. Each box lists metrics with a render type — `bar`, `number`, `text`, `spark`, `ammo`, `list`, or a `group`. Copy one and rearrange the boxes, swap icons, or change which metrics show.
+A preset is TOML: a `[bar]` style block, a `[mugshot]` block, and a list of `[[segment]]` boxes. Each box lists metrics with a render type — `bar`, `number`, `text`, `spark`, `ammo`, `list`, `scroll`, or a `group`. Copy one and rearrange the boxes, swap icons, or change which metrics show.
 
 ## How it works
 
@@ -110,6 +85,7 @@ See [`docs/ideation/`](docs/ideation/) for the full design write-up.
 
 - The status-face sprites are from **DOOM** (1993), id Software.
 - Mugshot rasterisation by **[chafa](https://hpjansson.org/chafa/)** (Hans Petter Jansson).
+- Prior art that shaped what this HUD shows: **[claude-hud](https://github.com/jarrodwatts/claude-hud)** and **[ccstatusline](https://github.com/sirmalloc/ccstatusline)**.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-doom-statusbar",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "DOOM-inspired status bar for the Claude Code CLI — a mugshot that tracks session health, plus usage, model, project, system, and a live subagent list.",
   "type": "module",
   "bin": {
@@ -15,7 +15,7 @@
   "scripts": {
     "statusline": "node src/statusline.js",
     "hook": "node src/hook.js",
-    "test": "node test/installer.test.mjs && node test/smoke.test.mjs && node test/hook-tasks.test.mjs && node test/statusline-tasks.test.mjs && node test/render-scroll.test.mjs && node test/e2e-tasks.test.mjs",
+    "test": "node test/installer.test.mjs && node test/smoke.test.mjs && node test/hook-tasks.test.mjs && node test/statusline-tasks.test.mjs && node test/render-scroll.test.mjs && node test/statusline-savings.test.mjs && node test/e2e-tasks.test.mjs",
     "preversion": "npm test",
     "postversion": "git push --follow-tags",
     "prepublishOnly": "npm test"

package/presets/default.toml

@@ -17,6 +17,14 @@ metric = [
   { id = "ratelimit.7d", render = "bar", icon = "📅", color = "threshold" },
 ]
 
+[[segment]]
+type  = "box"
+title = "SAVE"
+metric = [
+  { id = "save.leanctx", render = "text", icon = "🪶" },
+  { id = "save.lingua",  render = "text", icon = "📜" },
+]
+
 [[segment]]
 type = "mugshot"
 

package/presets/full.toml

@@ -30,6 +30,14 @@ metric = [
   { id = "cost.total",   render = "number", icon = "💰" },
 ]
 
+[[segment]]
+type  = "box"
+title = "SAVE"
+metric = [
+  { id = "save.leanctx", render = "text", icon = "🪶" },
+  { id = "save.lingua",  render = "text", icon = "📜" },
+]
+
 [[segment]]
 type  = "box"
 title = "PROJECT"

package/src/render.js

@@ -47,6 +47,7 @@ export const SAMPLE = {
   "act.geiger": [0, .25, .5, 1, .75, 1, .5, .6, .3, .1, .4, 1, .8, .4],
   "act.tasks": "2/5", "act.errors": "0", "sys.ram": 47, "sys.cpu": "12%",
   "sys.disk": 63, "sys.clock": "14:23",
+  "save.leanctx": "8.3k 63%", "save.lingua": "1.2k 1.3x",
 };
 
 let VALUES = SAMPLE;

package/src/statusline.js

@@ -45,6 +45,10 @@ function git(cwd, ...args) {
 // so an oversized repo or branch name can't blow up the PROJECT box width.
 const clip = (s, n) => ([...String(s)].length > n ? [...String(s)].slice(0, n - 1).join("") + "…" : String(s));
 
+// Human-readable token count: 8263 -> "8.3k", 1200000 -> "1.2M", 512 -> "512".
+// Lowercase k/M — the savings rows read softer than model.window's uppercase K/M.
+const k = (n) => (n >= 1e6 ? `${(n / 1e6).toFixed(1)}M` : n >= 1e3 ? `${(n / 1e3).toFixed(1)}k` : `${n}`);
+
 function _dur(secsF) {
   let secs = Math.max(0, Math.trunc(secsF));
   const d = Math.floor(secs / 86400); secs %= 86400;
@@ -228,6 +232,60 @@ function sysValues(cwd) {
   return v;
 }
 
+// Token-savings rows read from the small JSON files context-optimization tools already
+// persist. No plugin patching, no binary spawn — just a cheap read each refresh. Paths are
+// env-overridable (DOOMBAR_*) so tests can point at fixtures, mirroring statePath/MUGSHOT_STATE.
+const leanCtxPath = () => process.env.DOOMBAR_LEANCTX || path.join(os.homedir(), ".lean-ctx", "mcp-live.json");
+const llmlinguaPath = () => process.env.DOOMBAR_LLMLINGUA || path.join(os.homedir(), ".llmlingua-stats.json");
+
+// Defensive read: missing file or malformed JSON -> null (the row simply never appears).
+function readJson(p) {
+  try { return JSON.parse(readFileSync(p, "utf8")); } catch { return null; }
+}
+
+// One entry per savings source; extract returns the display string or null (omit the row).
+// Adding a source later is one entry here plus one preset line — not an adapter framework.
+const SAVINGS_SOURCES = [
+  {
+    key: "save.leanctx",
+    path: leanCtxPath,
+    extract: (d) => {
+      if (!(d.tokens_saved > 0)) return null;
+      // compression_rate is a 0-100 percentage (verified against historical data).
+      // Round it — a fractional value would render "63.45%" and shift the box width.
+      return typeof d.compression_rate === "number"
+        ? `${k(d.tokens_saved)} ${Math.round(d.compression_rate)}%`
+        : k(d.tokens_saved);
+    },
+  },
+  {
+    key: "save.lingua",
+    path: llmlinguaPath,
+    extract: (d) => {
+      // Prefer the nested session schema (smart-read). The flat lifetime-only shape
+      // (llmlingua_logged.py: tokens_saved_total, no session) is absent for the session view.
+      const s = d.session;
+      if (!s || !(s.tokens_saved > 0)) return null;
+      // Round/clamp the secondary figure so a many-decimal value can't shift box width.
+      if (s.last_saved_pct != null) return `${k(s.tokens_saved)} ${Math.round(s.last_saved_pct)}%`;
+      // No original-token count in the session block, so a percent isn't derivable; show the ratio.
+      if (s.last_ratio != null) return `${k(s.tokens_saved)} ${Number(s.last_ratio).toFixed(1)}x`;
+      return k(s.tokens_saved);
+    },
+  },
+];
+
+export function statsValues() {
+  const v = {};
+  for (const src of SAVINGS_SOURCES) {
+    const data = readJson(src.path());
+    if (!data) continue;
+    const out = src.extract(data);
+    if (out) v[src.key] = out; // omit on null/zero -> render.js available() drops the row
+  }
+  return v;
+}
+
 const PERM = { plan: "📋 plan", auto: "⏩ auto", acceptEdits: "⏩ auto", bypassPermissions: "⏩ bypass" };
 const OK_RGB = [96, 200, 104];   // matches render.js OK (done, green)
 const CRIT_RGB = [224, 84, 64];  // matches render.js CRIT (deleted, red)
@@ -259,11 +317,7 @@ export function activityValues(st, now) {
   const squad = st.squad || {};
   v["act.agents"] = String(Object.keys(squad).length);
   const agents = Object.values(squad).sort((a, b) => a.start - b.start);
-  v["act.subagents"] = agents.map((a) => {
-    let label = a.desc || a.type || "agent";
-    if ([...label].length > 20) label = [...label].slice(0, 19).join("") + "…";
-    return [label, _dur(now - a.start)];
-  });
+  v["act.subagents"] = agents.map((a) => [clip(a.desc || a.type || "agent", 24), _dur(now - a.start)]);
 
   const tasks = st.tasks && typeof st.tasks === "object" ? Object.values(st.tasks) : [];
   const live = tasks.filter((t) => t.status !== "deleted");
@@ -274,7 +328,7 @@ export function activityValues(st, now) {
     .sort((a, b) => (TASK_ORDER[a.status] - TASK_ORDER[b.status]) || (a.ts - b.ts));
   v["act.tasklist"] = ordered.map((t) => {
     const [mark, markRgb] = TASK_MARK[t.status] || ["🎯", null];
-    return { mark, markRgb, text: t.title };
+    return { mark, markRgb, text: clip(t.title, 24) };
   });
 
   if ("errors" in st) v["act.errors"] = String(st.errors);
@@ -291,7 +345,7 @@ function main() {
   const now = Date.now() / 1000;
   const st = readState(data);
   const cwd = data.cwd || (data.workspace || {}).current_dir;
-  const values = { ...buildValues(data), ...activityValues(st, now), ...sysValues(cwd) };
+  const values = { ...buildValues(data), ...activityValues(st, now), ...sysValues(cwd), ...statsValues() };
   const [advModel, advTs] = advisorInfo(data.transcript_path || "");
   if (advModel) values["advisor.model"] = advModel;
   const god_until = godFlash(data, advTs, now);