jarrodwatts/claude-hud

Claude HUD is a plugin for Claude Code, an AI-powered command-line coding assistant, that adds a live status bar at the bottom of your terminal window. When you're working with Claude Code, it can be hard to tell what's happening behind the scenes: how much of the AI's memory ("context window") has been used, which tools it's currently running, and how far along it is on a list of tasks. Claude HUD solves this by keeping all that information visible at a glance, right below where you type. The plugin works by reading a stream of data that Claude Code already produces, including token counts, tool activity logs, and task lists, and then formatting that into a compact status line that updates roughly every 300 milliseconds. The data comes directly from Claude Code itself rather than being estimated, so the context usage percentages are accurate. You can see the AI model in use, a progress bar showing how full the context window is, which files it's reading or editing at that moment, whether any "subagents" (smaller AI workers it spun up to handle subtasks) are running, and a live count of how many to-do items have been completed. Installation happens entirely inside Claude Code using its built-in plugin system: you add a marketplace, install the plugin, then run a setup command that configures the status line. After a restart, the HUD appears automatically. A configuration wizard lets you choose between preset layouts (Full, Essential, or Minimal), toggle individual elements on or off, switch label languages between English and Chinese, and control details like how many directory levels of your project path to show. The plugin is written in JavaScript and TypeScript and works in any terminal without requiring extra tools like tmux or a separate window.