oh-my-cchud

oh-my-cchud

Performance-focused HUD for Claude Code — fed by two sources, the native statusLine JSON (stdin) and the session transcript JSONL, rendered as fast composable segments.

English · 한국어

[oh-my-cchud]  Opus  ⎇ main*3  ⇡ #1234 pending  ██████████░░░░ 73%  5h 41% (2h11m)  7d 88% (3d3h)
✱ high  ✻  code-reviewer ⟳1  ☑ 4/6 fixing transcript parser

A bottom-of-terminal status line: project · model · git · context usage · rate limits · reasoning effort · subagents · todo progress. No extra window or tmux. Bun + TypeScript, zero runtime deps.

Install

Plugin

/plugin marketplace add choo121600/oh-my-cchud
/plugin install oh-my-cchud@oh-my-cchud
/reload-plugins          # REQUIRED — activates the plugin; its commands aren't registered until you reload
/oh-my-cchud:install     # wire the main statusLine — re-run after each /plugin update

Requires Bun on PATH (the status line runs bun). A plugin can only auto-apply subagentStatusLine, so /oh-my-cchud:install wires the main HUD into your ~/.claude/settings.json through a stable launcher that survives plugin updates. (Re-added the marketplace before this push? Run /plugin marketplace update oh-my-cchud first.)

Manual (clone)

bun run scripts/install-statusline.ts    # writes statusLine into ~/.claude/settings.json (backup made)

Or set it by hand —

~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "bun /abs/path/to/oh-my-cchud/src/statusline.ts",
    "refreshInterval": 2
  }
}

Configure

Copy config.example.json to ~/.claude/oh-my-cchud.json (shallow-merged over defaults — set only what you change). Also read from OH_MY_CCHUD_CONFIG or ${CLAUDE_PLUGIN_ROOT}/config.json.

{
  "theme": "default",
  "lines": [
    ["project", "model", "worktree", "git", "pr", "context", "rate"],
    ["effort", "thinking", "status", "agents", "todos"]
  ],
  "context": { "barWidth": 14, "warn": 70, "crit": 90 },
  "rate": { "warn": 60, "crit": 85, "reset": "relative" },
  "transcript": { "tailBytes": 131072, "recentTools": 3 },
  "git": { "cacheMs": 3000 }
}

• lines — each array is one row; values are segment names. Reorder freely or merge into one line. worktree/pr auto-hide when absent.
• theme — default (Unicode) · nerd (Nerd Font) · ascii (plain). OH_MY_CCHUD_THEME=ascii for a quick switch; NO_COLOR honored.
• rate.reset — relative (in 2h12m) · clock (14:30) · off.

Segments

name	shows	source	default
project	[name] anchor (project_dir basename)	stdin	✅
model	model display name	stdin	✅
context	context bar + % (green→yellow→red), the /compact cue	stdin	✅
rate	5h/7d limit % + time-to-reset (2h12m)	stdin (Pro/Max)	✅
git	branch + dirty count (cached; branch links to repo)	git + stdin	✅
worktree	worktree name:branch	stdin	✅
effort	reasoning effort level (colored by intensity)	stdin	✅
thinking	thinking active (✻)	stdin	✅
agents	running subagents	transcript	✅
todos	☑ done/total + active item	transcript	✅
pr	PR number + review state (clickable; only with an open PR)	stdin	✅
status	Claude Code service status — shows only during an incident/outage	status.claude.com	✅
cost	cost $ + elapsed (12m34s)	stdin	⬜
tools	● active / recent tools	transcript	⬜
output_style	non-default output style name	stdin	⬜

Opt-in segments are off by default — add the name to a line to enable. (why these are off)

Single line — merge into one array; reasoning state reads well next to the model:

{ "lines": [["project", "model", "effort", "thinking", "git", "context", "rate", "todos"]] }

Build a binary (optional)

bun run build   # -> dist/cchud (self-contained; no bun on PATH needed)

Preview

bun run scripts/demo.ts [transcript.jsonl]   # all three themes, no live session needed

Releasing

One command bumps the version, commits, and pushes:

bun run release patch   # 0.1.3 -> 0.1.4   (also: minor | major | x.y.z)

Once the bump lands on main, the release workflow typechecks, then tags and publishes the matching GitHub release automatically — so a forgotten git tag / gh release can never leave releases lagging behind the code.

More

• Architecture, performance & design rationale — DESIGN.md
• Official statusLine docs — https://code.claude.com/docs/en/statusline
• Inspiration — jarrodwatts/claude-hud, npow/oh-my-claude

License

MIT © choo121600