Skip to content

hud 0.1.0: a live usage HUD above the prompt (replaces buddy) - #2

Merged
Samarth2001 merged 6 commits into
mainfrom
hud-0.1.0
Oct 3, 2026
Merged

Samarth2001 merged 6 commits into
mainfrom
hud-0.1.0

Conversation

@Samarth2001

Copy link
Copy Markdown
Owner

What

Adds hud 0.1.0, a live usage HUD above the Claude Code prompt, and removes buddy. Existing buddy installs migrate to hud through the renames map (Claude Code v2.1.193 or later).

  • One flat row: what Claude is doing, context, each plan limit with a pace-aware meter, tokens and spend. It picks the richest layout that fits.
  • Press a label to open a drawer: turns, context outlook, limits with pace and reset forecasts, spend over 7 days, 30 days or 12 months.
  • /hud opens a dashboard pane with every drawer.
  • Terminal: colored cells, with Claude's own spinner and clay color while it works.
  • Desktop and VS Code: lit icon tiles and vector meters and charts. Animations start at the clock's phase, so a reload never restarts them.
  • A per-session, per-day spend ledger in the plugin's store, pruned after 400 days.

Repo

  • CI, CONTRIBUTING, CLAUDE.md and the release skill run claude plugin validate --strict, as Anthropic's publishing guide recommends.
  • The root README stays neutral: one generated catalog row.

Checks

  • claude plugin validate --strict . and plugins/hud: pass
  • claude plugin test plugins/hud: 27 pass
  • scripts/catalog.mts --check: consistent
  • scripts/check-version-bumps.sh main HEAD: hud is a new plugin at 0.1.0

After merge: claude plugin tag plugins/hud --push publishes the release.

🤖 Generated with Claude Code

Samarth2001 and others added 6 commits October 3, 2026 20:11
A one-line glance above the prompt (heartbeat, context sparkline, plan
limit meters with an even-pace mark, spend for session, today and month)
that expands into Context, Limits, Cost and Turns tabs, plus a /pulse
dashboard pane. Spend by day, week and month comes from a per-session,
per-day ledger in the plugin's store.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Fit the glance row at every width (gap before the expand control, shorter
separators below 120 columns), underline the open tab instead of a marker,
move the Cost ranges atop the tab below 90 columns, align the Turns columns,
and print multi-day spans as "4d 0h".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Delete plugins/buddy and its asset script, drop its marketplace entry and
catalog row, and map "buddy" to "pulse" under renames so existing installs
migrate to pulse instead of failing with "not found in marketplace".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The band is one row; pressing a label opens a one-row drawer with that
metric's detail. Gauges are drawn per surface: colored Raster cells in the
terminal (fading heartbeat, heat meters, bar and area charts, a turn
timeline) and animated SVGs on desktop and VS Code (scrolling pulse with a
ripple, context ring, capsule meters that slide to new values, charts that
grow in). The dashboard pane shows every drawer, larger.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Anthropic's publishing guide recommends --strict for CI, so warnings such
as an unknown manifest field fail the run. CI, CONTRIBUTING, CLAUDE.md and
the release skill now all use it. CONTRIBUTING's commit example names no
plugin, and machine-local Claude Code files are gitignored.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The name pulse is close to another plugin's, so the unreleased plugin
becomes hud (/hud), and buddy installs migrate straight to it.

- Desktop: flat one-line row with lit icon tiles; charts drawn as vectors so
  they line up; loops start at the clock's phase so a reload never restarts
  them; a turn redraws once a second; a changed value glows in color.
- Terminal: the same flat layout, with Claude's spinner and clay.
- Fixed an invalid SVG (duplicate attribute) that broke the cost icon.
- Prunes old per-session totals from the store and loads the ledger in one
  batch; removes dead helpers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Samarth2001
Samarth2001 merged commit f3285f8 into main Oct 3, 2026
2 checks passed
@Samarth2001
Samarth2001 deleted the hud-0.1.0 branch October 3, 2026 22:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant