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.
Try it · mini version
See what it can do
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.
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.


