hud

Configure an OpenCode HUD statusline with display presets and ANSI handling.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kamelmh/opencode --skill hud-kamelmh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/kamelmh/opencode/tree/main/skills/hud
Command: npx skills add https://github.com/kamelmh/opencode --skill hud-kamelmh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The hud Skill prevents lost time and confusion by letting you configure a consistent, readable statusline that shows the current OpenCode session state instead of forcing you to remember what’s running and where you are.

Core Features & Use Cases

  • Auto-setup and repair: Ensures the HUD wrapper script and required settings are present under your configured config directory, and guides you to restart when changes are made.
  • Display presets: Switches between minimal, focused (default), and full layouts tailored to how much detail you want while working.
  • Multi-line runtime visibility: Presents agent execution details (hierarchy, durations, and short descriptions) during active runs so you can monitor progress at a glance.
  • Config tuning knobs: Supports manual configuration of elements, thresholds, formatting options, and safety behavior for terminals.

Quick Start

Run hud setup to install or repair the HUD statusline and enable the focused preset.

Frequently Asked Questions about hud

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a statusline to monitor real-time agent execution details in OpenCode?▼

The hud Skill configures the OpenCode statusline to show real-time session state, including execution mode, active skill, context usage, agents, and task progress, preventing the need to manually check what is currently running.

What display presets are available for the OpenCode HUD statusline?▼

The OpenCode HUD statusline supports minimal, focused, and full display presets, allowing you to switch layouts based on how much runtime visibility and detail you want during interactive multi-agent workflows.

How do I repair or migrate the HUD wrapper script and settings.json file?▼

Running the hud setup command auto-repairs the HUD wrapper script and migrates the settings.json statusLine command under the OPENCODE_CONFIG_DIR, guiding you to restart your session after applying the changes.

Does the OpenCode statusline support safe ANSI handling for different terminals?▼

Yes, the OpenCode statusline configuration includes safety behavior and formatting options to ensure safe ANSI handling across different terminals during active multi-agent runs and context visibility display.

Why do I need a statusline for interactive multi-agent workflows?▼

A statusline provides real-time visibility into execution mode, active skill, context usage, and task progress, preventing lost time and confusion by showing the current OpenCode session state without requiring manual status checks.