tart All work

PERSONAL / DEVELOPER TOOLS

Claude Code Mods

cc-hud is a Claude Code mod that brings prompt cache, usage forecasts and live agent activity into one clickable heads-up display.

Personal project · Mod development & interface design

My contribution

Built cc-hud on cache-tax, adding plan-usage forecasts, turn and tool tracking, a live Agents pane, and task-specific animated pixel costumes. The pane concept is inspired by savvy-progress.

Download CV (English)

Try it · mini version

See what it can do

cc-hud running in the Claude desktop app, with the heads-up row above the prompt and the Agents pane open on the right
Real desktop capture from the cc-hud repository · chat text is blurred for privacy.

Personal open-source project · Claude Code Mods · October 2026

The problem

During an AI coding session, cache expiry, plan limits and parallel agent activity are easy to lose track of while switching between views.

What this delivers

A compact interactive row above the prompt, an expandable usage breakdown and a live Agents pane showing tasks, tool calls and answers. The interface adapts to narrow terminals and light or dark themes.

What this project does

cc-hud keeps the coding session’s operational details close to the prompt. See whether the cache is warm, how much session and weekly quota remains, when limits reset, and what the main agent and subagents are doing. Click the row to inspect usage or open the Agents pane.

Inside the project

  • Track cache warmth and expiry, session and weekly plan usage, reset times and pace-based forecasts. Cost and cache-savings figures are estimates at API prices.
  • Inspect the main agent and subagents in a live pane: task, model, tokens, cost, elapsed time, tool calls with results, and the rendered answer. Secret masking is best effort.
  • Give agents animated pixel costumes that reflect their tasks and running, waiting, finished or failed states. Respect reduced-motion settings and use emoji costumes in the terminal.
  • Keep the row readable at different widths, with compact and detailed layouts, clickable actions, theme-aware styling, and optional completion notifications and chimes.
  • Install through the Claude Code plugin marketplace. The HUD reads existing session figures; optional keepwarm pings are model requests, consume tokens and start off in each new session.

Skills & practical experience

Practice building an event-driven TypeScript mod, fitting useful information into constrained layouts, forecasting usage from session data, and presenting parallel work with clear state and accessible motion.

TypeScriptClaude Code ModsDeveloper toolingUsage forecastingResponsive UIPixel animation

The hero image is a real desktop capture from the public repository, with chat content blurred for privacy. The row and pane previews are rendered from the project’s own code with sample data. The repository includes source, tests, installation instructions and credits.

Project context

An MIT-licensed community mod for the terminal and the Claude desktop app’s Code tab, distributed as a Claude Code plugin. It builds on cache-tax by Karan Bansal and is inspired by savvy-progress by JohnnyVizz. The Claude mascot belongs to Anthropic; cc-hud is not affiliated with Anthropic.

Read session stateTrack cache & quotaInspect running agentsAct from the HUD

Project media

cc-hud compact, working and expanded row layouts rendered with sample data
Compact and expanded HUD layouts · rendered preview with sample data.
cc-hud Agents pane showing folded agents, tool-call details and an expanded answer with sample data
Agents pane with tool calls and answers · rendered preview with sample data.