HUD lines truncated/hidden in narrow terminal splits

[xiangboit]

Problem

When using terminal splits (e.g. tmux panes, VS Code split terminal, iTerm2 split), the HUD output gets truncated by the terminal. Lines like MCP servers, Bash/Edit/Glob tool counts, and todo progress are pushed off-screen and replaced by system prompts.

Only the first 1-2 lines (model info + context bar) remain visible. The rest of the HUD content is effectively hidden.

Environment

• macOS + iTerm2 / VS Code integrated terminal
• Terminal width: ~80 cols (split pane)
• claude-hud v0.0.9

Expected Behavior

HUD should adapt to narrow terminals by either:

• Condensing information into fewer lines
• Prioritizing the most important lines (e.g. usage, context) when space is limited
• Collapsing less critical sections (tools, todos, agents) at narrow widths

Current Behavior

All lines are rendered at full width regardless of available terminal space. In narrow splits, the lower lines are pushed below the visible area and get overwritten by Claude Code's own output.

Possible Approaches

1. Responsive line collapsing — detect terminal width and hide low-priority lines when below a threshold
2. Compact mode — a config option for a minimal single-line or two-line layout
3. Priority-based rendering — always show usage + context, conditionally show tools/todos/agents based on available rows

Happy to help implement if there's a preferred direction.

[ashishtiwari03]

Hi! I’d like to take a look at this issue. My initial idea is to detect terminal width and render a compact HUD layout when the width is below a threshold. Please let me know if that approach aligns with the intended direction before I start working on a fix.

[jarrodwatts]

Closing as already resolved on current main. The renderer now wraps output to terminal width and keeps activity lines visible, with regression coverage in tests/render-width.test.js. If you can still reproduce on the latest release, please reopen with the exact viewport/terminal behavior you see.