# Claude HUD

## Docs

- [/claude-hud:configure](https://mintlify.wiki/jarrodwatts/claude-hud/commands/configure.md): Interactive guided flow to configure HUD display options — layout, presets, and individual element toggles — while preserving advanced manual settings.
- [/claude-hud:setup](https://mintlify.wiki/jarrodwatts/claude-hud/commands/setup.md): Configure claude-hud as your statusline by detecting your platform and writing the statusLine command to ~/.claude/settings.json.
- [Colors](https://mintlify.wiki/jarrodwatts/claude-hud/configuration/colors.md): Customize the color roles Claude HUD uses for context bars, usage bars, warnings, and critical states.
- [Display options](https://mintlify.wiki/jarrodwatts/claude-hud/configuration/display-options.md): Reference for every display option in Claude HUD, including layout, element visibility, and context bar format.
- [Git status](https://mintlify.wiki/jarrodwatts/claude-hud/configuration/git-status.md): Configure how Claude HUD displays your git branch, dirty state, and file change counts.
- [Configuration overview](https://mintlify.wiki/jarrodwatts/claude-hud/configuration/overview.md): How to configure Claude HUD — from interactive setup to manual JSON editing.
- [Presets](https://mintlify.wiki/jarrodwatts/claude-hud/configuration/presets.md): Apply a preset to quickly configure Claude HUD for your preferred level of detail.
- [Usage limits](https://mintlify.wiki/jarrodwatts/claude-hud/configuration/usage-limits.md): How Claude HUD displays rate limit consumption for Pro, Max, and Team subscribers, and how to configure its behavior.
- [Changelog](https://mintlify.wiki/jarrodwatts/claude-hud/development/changelog.md): All notable changes to Claude HUD, organized by release version.
- [Contributing](https://mintlify.wiki/jarrodwatts/claude-hud/development/contributing.md): How to set up, build, test, and submit changes to Claude HUD.
- [How it works](https://mintlify.wiki/jarrodwatts/claude-hud/guides/how-it-works.md): A technical deep-dive into Claude HUD's data flow, invocation model, and internal architecture.
- [Layouts](https://mintlify.wiki/jarrodwatts/claude-hud/guides/layouts.md): Understand and configure the expanded, compact, and compact-with-separators layout modes.
- [Troubleshooting](https://mintlify.wiki/jarrodwatts/claude-hud/guides/troubleshooting.md): Solutions to common Claude HUD setup and display problems.
- [Introduction](https://mintlify.wiki/jarrodwatts/claude-hud/introduction.md): Claude HUD is a Claude Code plugin that shows context usage, active tools, running agents, and todo progress — always visible below your input.
- [Quickstart](https://mintlify.wiki/jarrodwatts/claude-hud/quickstart.md): Install Claude HUD and get your real-time statusline running in minutes.