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 +8 -32
- package/package.json +1 -1
- package/src/statusline.js +2 -6
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
|
|
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,
|
|
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,
|
|
19
|
-
- **ACTIVITY** — a tool-activity "geiger" sparkline (duty-cycle over the last 30 s), running-
|
|
20
|
-
- **
|
|
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.
|
|
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);
|