A comprehensive, btop-inspired statusline HUD for Claude Code
npx claudepluginhub thewhey-brian/claude-statusline-hudA comprehensive, btop-inspired statusline HUD for Claude Code with context, rate limits, session stats, system vitals, and configurable presets.
Thewhey-BrianA comprehensive, btop-inspired statusline HUD plugin for Claude Code. Cross-platform (macOS + Linux) with adaptive terminal width.
Full preset on wide terminal: identity, live activity, context/usage bars, session stats
Full preset on normal terminal: adaptive layout with all key metrics
Wide (≥100 cols):
[Opus 4.6 (1M context) | Max] │ my-project │ main ✓ ↑2 │ ⚡ agent
Normal (70–99 cols):
[Opus 4.6 | Max] │ my-project │ main ✓
Compact (<70 cols):
[Opus | Max] │ my-project │ main ✓
Wide (≥100 cols):
[Opus 4.6 (1M context) | Max] │ my-project │ main [+2 ~1] ↑2
› ◐ Edit auth.ts ✓ Read ×3 │ ▸ Fix auth bug (2/5)
Context ██████████ 42% │ Usage ██░░░░░░░░ 6% (0h 18m / 5h) │ ██████████ 23% (1d 14h / 7d)
Activity row only shows when tools/todos/agents are active — otherwise 2 rows.
Compact (<70 cols):
[Opus | Max] │ my-project │ main ✓
Context ██████ 42% │ 5h ██████ 6% │ 7d ██████ 23%
Wide (≥100 cols):
[Opus 4.6 (1M context) | Max] │ my-project │ main ✓ ↑2 │ ⚡ agent
› ◐ Edit auth.ts ✓ Read ×3 │ ▸ Fix auth bug (2/5) │ ⚡ explore
Context ██████████ 42% │ Usage ██░░░░░░░░ 6% (0h 18m / 5h) │ ██████████ 23% (1d 14h / 7d)
$1.31 │ ⏱ 12m 3s (api 68%) │ +142 -38 ▲ │ cache 87% │ 1k/min
At high context (85%+), a token breakdown row appears:
Context █████████░ 87% ⚠ │ Usage ...
tokens 179k/200k — in 30k cached 140k created 5k out 4k
Activity row only shows when tools/todos/agents are active — otherwise hidden.
Compact (<70 cols):
[Opus | Max] │ my-project │ main ✓
Context ██████ 42% │ 5h ██████ 6% │ 7d ██████ 23%
$1.31 │ ⏱ 12m 3s │ +142 -38 ▲
Wide (≥100 cols):
[Opus 4.6 (1M context) | Max] │ my-project │ main ✓ ↑2 │ ⚡ agent
› ◐ Edit auth.ts ✓ Read ×3 │ ▸ Fix auth bug (2/5)
Context ██████████ 42% │ Usage ██░░░░░░░░ 6% (0h 18m / 5h) │ ██████████ 23% (1d 14h / 7d)
$1.31 │ ⏱ 12m 3s (api 68%) │ +142 -38 ▲ │ cache 87% │ 1k/min
cpu ██▌ 35% │ mem ███▊ 15G/16G │ gpu █ 11% │ disk ▋ 15G/926G │ bat ████ 80% │ load 2.41
Compact (<70 cols):
[Opus | Max] │ my-project │ main ✓
Context ██████ 42% │ 5h ██████ 6% │ 7d ██████ 23%
$1.31 │ ⏱ 12m 3s │ +142 -38 ▲
cpu ██▌ 35% │ mem ███▊ 15G/16G │ gpu █ 11%
# Step 1: Add the marketplace
/plugin marketplace add Thewhey-Brian/claude-statusline-hud
# Step 2: Install the plugin
/plugin install claude-statusline-hud
The plugin auto-configures on the next session start via a SessionStart hook. If the statusline doesn't appear, run the setup script manually:
bash ~/.claude/plugins/cache/claude-statusline-hud/claude-statusline-hud/*/scripts/setup.sh
The plugin checks for updates on each session start. If a newer version is available, you'll see a yellow ↑ v1.3.0 badge on Row 1. To update:
# Step 1: Fetch latest catalog
/plugin marketplace update claude-statusline-hud
# Step 2: Reinstall
/plugin uninstall claude-statusline-hud
/plugin install claude-statusline-hud
Then restart your Claude Code session.
Note: Plugins don't auto-update in Claude Code. You need to manually reinstall to get new versions.
# Step 1: Remove statusLine config
bash ~/.claude/plugins/cache/claude-statusline-hud/claude-statusline-hud/*/scripts/teardown.sh
# Step 2: Remove the plugin
/plugin uninstall claude-statusline-hud
claude --plugin-dir /path/to/claude-statusline-hud/plugins/claude-statusline-hud
| Preset | Rows | What you see |
|---|---|---|
minimal | 1 | Model, directory, git branch & status |
essential | 2–3 | + Activity (when active), context/usage bars |
full | 3–5 | + Session stats, token breakdown at 85%+ (default) |
vitals | 4–6 | + System vitals (CPU, memory, GPU, disk, battery, load) |
# Option 1: Write to file
echo "vitals" > ~/.claude/statusline-preset
# Option 2: Environment variable
export CLAUDE_STATUSLINE_PRESET=essential
# Option 3: Use the built-in skill
/statusline
The statusline automatically adapts to your terminal width: