Skip to content

v0.4.0 — first stable release

Latest
Latest

Choose a tag to compare

View all tags
@explosivebit explosivebit released this 07 May 23:27
· 1 commit to main since this release
v0.4.0
9a472d6

forgeplan-hud is a two-line heads-up display for the Claude Code CLI, wired into the ForgePlan ecosystem.

Pure bash + jq, ~60 ms hot path, bash 3.2 compatible (works on stock macOS).

Demo

🔨 ADR-012 ▸ "Slug-canonical identity with di…"  routing/standard  R 0.76 ●●●●●●●●○○  EVID×2
⬢ Opus 1M  ▮▮▯▯▯▯▯▯▯▯ 24%  $10.55  5h 31%·7d 41%  ⏱ 1h 03m

What's in v0.4.0

Layout

  • Two-line composition: ForgePlan zone above, Claude session zone below
  • ForgePlan zone hidden gracefully when no .forgeplan/ is in the cwd ancestry

Context awareness (U-curve)

  • 4-tier hint ladder: prep handoff → mid fades → /compact NOW → NEW SESSION
  • Two threshold profiles for 200k and 1M context windows
  • Field-calibrated 1M thresholds (50 / 65 / 80 / 92) after real-world Opus 4.7 usage showed earlier alerts were noise

Forgeplan zone

  • Active artifact ID + truncated title + phase/depth
  • R_eff bar with FGR thresholds (≥0.6 green, 0.3-0.6 brand orange, <0.3 red) — mirrors ForgePlanWeb
  • Evidence count, orphan alerts, stale-cache marker

Smart idle dashboard

  • Hybrid health summary: short CTA when healthy, expanded counts when needs_attention or critical
  • Prioritized category hint: stale > mismatch > orphans > stubs > at-risk > blind > drafts > route
  • Priority-driven verdict marker: ⚠ for warnings, ✕ for critical

Bilingual i18n

  • Every user-facing hint has an EN — RU pair joined by em-dash
  • lib/05-i18n.sh uses case-dispatch (no declare -A — works on bash 3.2)
  • Add a new hint = add a single branch

Claude session zone

  • Worktree marker ⌥, agent badge [agent: name]
  • Cost emphasis: dim < $1, brand orange < $5, red ≥ $5
  • Rate-limit alert at ≥80% (5h or 7d)
  • Session duration

Distribution

  • install.sh / uninstall.sh with safe ~/.claude/settings.json patching (preserves backup)
  • test/run.sh snapshot-style runner with synthetic stdin fixtures
  • README aligned with forgeplan, @forgeplan/web, and the marketplace (EN + RU)

Install

curl -fsSL https://raw.githubusercontent.com/ForgePlan/forgeplan-hud/main/install.sh | bash

Restart any open Claude Code sessions to pick up the bar.

Requirements

  • bash 3.2+ (default on macOS)
  • jq
  • forgeplan CLI is optional — bar gracefully shows only the Claude line without it

Part of the ForgePlan ecosystem alongside forgeplan, @forgeplan/web, and the marketplace.

Assets 2
Loading