Skip to main content

Quickstart

Install Claude HUD and get your statusline up and running in minutes.

Configuration

Customize your HUD with presets, display options, and color themes.

How it works

Learn how Claude HUD reads native token data and parses your transcript.

Troubleshooting

Fix common issues with setup, display, and usage limits.

​
What is Claude HUD?

Claude HUD gives you real-time visibility into your Claude Code session — always visible as a statusline below your input field. No separate window, no tmux required. 
[Opus | Max] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)
◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2
◐ explore [haiku]: Finding auth code (2m 15s)
▸ Fix authentication bug (2/5)

​
Key features

Context health

Know exactly how full your context window is before it’s too late. Color-coded bar turns yellow at 70% and red at 85%.

Tool activity

Watch Claude read, edit, and search files as it happens. See running and completed tool counts at a glance.

Agent tracking

See which subagents are running, their model, and what they’re working on — with elapsed time.

Todo progress

Track task completion in real-time as Claude works through your TodoWrite list.

Usage limits

Monitor your 5-hour and 7-day rate limit consumption for Claude Pro, Max, and Team plans.

Git status

See your current branch, uncommitted changes, and ahead/behind counts inline.

​
Requirements

  • Claude Code v1.0.80 or later
  • Node.js 18+ or Bun
Claude HUD uses Claude Code’s native statusline API. It receives accurate token data directly from Claude Code via stdin — no estimation required.

Build docs developers (and LLMs) love

Get started for freeTalk to us