HUD Mode

hud

A compact heads-up display for your coding agent. Instruments while it
works, the answer when it stops - for
OpenCode,
Claude Code, and
Codex.
Zero dependencies.

The instruments and the activity line update in place - no scrolling wall of
tool calls. The prompt bar is always writable: hit enter mid-turn and
your message queues, firing the moment the answer lands. esc interrupts
without losing the session.

When it stops, the answer lands in full - markdown rendered, links
clickable - and you reply right there. Sending a follow-up recompacts the
screen back to just instruments and prompt bar.

Install

One command:

hud install walks you through it: your default agent, echo setup for
opencode if you want it, and where /hud lives - then wires the handback
into all three CLIs.

Requires Node ≥ 18 and at least one of opencode, claude, codex on your
PATH.

Use

Launch flags: -m/--model, -e/--effort, --danger (engine-specific
values).

At the ❯ prompt:

The toggle

/hud works in both directions. From the hud it opens the same session in
the engine's full TUI; from the full TUI you come back - same session,
nothing lost, terminal wiped clean:

Quitting any full TUI (ctrl+c) always returns to the hud too.

Instruments

- STS status flag (NORM / PERM / INTR / FAULT) · MDL model ·
  MODE permission/sandbox mode · EFF reasoning effort · MSG messages ·
  T+ elapsed · TOK output tokens (reasoning included) · AGT live
  subagents · USD session cost (where the engine reports it) · CTX
  context size · DSK conversation size on disk (claude, codex)
- The cluster flows onto a second aligned row rather than dropping gauges.
- The activity line shows what the agent is doing right now (READ,
  EDIT, EXEC, SCAN, NET, AGENT, PLAN, THINK…); the ┄ line
  carries its own narration.
-…