claude-doom-statusbar 0.3.0 → 0.3.1

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.
package/README.md CHANGED
@@ -1,9 +1,9 @@
1
1
  # claude-doom-statusbar
2
2
 
3
- 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.
3
+ 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.
4
4
 
5
5
  <p align="center">
6
- <img src="assets/images/hud.png" alt="claude-doom-statusbar HUD: MODEL, USAGE, PROJECT, the DOOM mugshot, ACTIVITY, SUBAGENTS and SYS boxes">
6
+ <img src="assets/images/hud.png" alt="claude-doom-statusbar HUD: MODEL, USAGE, PROJECT, the DOOM mugshot, ACTIVITY, AGENTS, TASKS and SYS boxes">
7
7
  </p>
8
8
 
9
9
  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
15
15
  - **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.
16
16
  - **MODEL** — model name + reasoning effort (a waxing-moon→sun icon), thinking/fast toggles, output style, and the configured `/advisor` model.
17
17
  - **USAGE** — context window (HP bar), the 5h / 7d rate-limit bars (with reset countdowns), RAM, session cost.
18
- - **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.
19
- - **ACTIVITY** — a tool-activity "geiger" sparkline (duty-cycle over the last 30 s), running-subagent count, task progress, error count.
20
- - **SUBAGENTS** — a live list of running subagents (type/description + ticking runtime), always visible, widening to fit.
18
+ - **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.
19
+ - **ACTIVITY** — a tool-activity "geiger" sparkline (duty-cycle over the last 30 s), running-agent count, task progress, error count.
20
+ - **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.
21
+ - **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.
21
22
  - **SYS** — CPU, disk, session length, wall clock.
22
23
 
23
24
  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
54
55
  npx claude-doom-statusbar@latest install
55
56
  ```
56
57
 
57
- ### Manual wiring
58
-
59
- 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):
60
-
61
- ```json
62
- {
63
- "env": { "DOOMBAR_PRESET": "/abs/path/claude-doom-statusbar/presets/full.toml", "FORCE_HYPERLINK": "1" },
64
- "statusLine": {
65
- "type": "command",
66
- "command": "node \"/abs/path/claude-doom-statusbar/src/statusline.js\"",
67
- "refreshInterval": 1
68
- },
69
- "hooks": {
70
- "PreToolUse": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
71
- "PostToolUse": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
72
- "PostToolUseFailure": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
73
- "Stop": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
74
- "PermissionDenied": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
75
- "SubagentStart": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
76
- "SubagentStop": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
77
- "TaskCreated": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }],
78
- "TaskCompleted": [{ "hooks": [{ "type": "command", "command": "node \"/abs/path/claude-doom-statusbar/src/hook.js\"" }] }]
79
- }
80
- }
81
- ```
82
-
83
58
  ### Clickable links
84
59
 
85
60
  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
96
71
  - **`default`** — balanced HUD.
97
72
  - **`full`** — every box, the look in the screenshot above.
98
73
 
99
- 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.
74
+ 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.
100
75
 
101
76
  ## How it works
102
77
 
@@ -110,6 +85,7 @@ See [`docs/ideation/`](docs/ideation/) for the full design write-up.
110
85
 
111
86
  - The status-face sprites are from **DOOM** (1993), id Software.
112
87
  - Mugshot rasterisation by **[chafa](https://hpjansson.org/chafa/)** (Hans Petter Jansson).
88
+ - Prior art that shaped what this HUD shows: **[claude-hud](https://github.com/jarrodwatts/claude-hud)** and **[ccstatusline](https://github.com/sirmalloc/ccstatusline)**.
113
89
 
114
90
  ## License
115
91
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-doom-statusbar",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "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.",
5
5
  "type": "module",
6
6
  "bin": {
package/src/statusline.js CHANGED
@@ -259,11 +259,7 @@ export function activityValues(st, now) {
259
259
  const squad = st.squad || {};
260
260
  v["act.agents"] = String(Object.keys(squad).length);
261
261
  const agents = Object.values(squad).sort((a, b) => a.start - b.start);
262
- v["act.subagents"] = agents.map((a) => {
263
- let label = a.desc || a.type || "agent";
264
- if ([...label].length > 20) label = [...label].slice(0, 19).join("") + "…";
265
- return [label, _dur(now - a.start)];
266
- });
262
+ v["act.subagents"] = agents.map((a) => [clip(a.desc || a.type || "agent", 24), _dur(now - a.start)]);
267
263
 
268
264
  const tasks = st.tasks && typeof st.tasks === "object" ? Object.values(st.tasks) : [];
269
265
  const live = tasks.filter((t) => t.status !== "deleted");
@@ -274,7 +270,7 @@ export function activityValues(st, now) {
274
270
  .sort((a, b) => (TASK_ORDER[a.status] - TASK_ORDER[b.status]) || (a.ts - b.ts));
275
271
  v["act.tasklist"] = ordered.map((t) => {
276
272
  const [mark, markRgb] = TASK_MARK[t.status] || ["🎯", null];
277
- return { mark, markRgb, text: t.title };
273
+ return { mark, markRgb, text: clip(t.title, 24) };
278
274
  });
279
275
 
280
276
  if ("errors" in st) v["act.errors"] = String(st.errors);