thud.sh

A tiny tmux HUD for keeping agent work visible.

thud shows your tmux sessions, windows, panes, and agent status in one terminal view. Leave it open as a monitor, or invoke it for quick actions like jumping to the next pane that needs attention.

Install

Requirements:

• tmux
• Bun

Install with your package manager:

npm:

npm install -g thud.sh

Bun:

bun add -g thud.sh

pnpm:

pnpm add -g thud.sh

Usage

thud

The app is keyboard-first and explains itself. Press ? for shortcuts or Ctrl+P for commands.

Useful entry points:

thud jump
thud --mode=popup
thud help
thud version

Example tmux bindings:

bind-key J run-shell 'thud jump "#{pane_id}"'
bind-key T display-popup -E -w 90% -h 90% 'thud --mode=popup'

OpenCode status integration

To show OpenCode pane status in thud:

opencode plugin thud.sh

Development

bun install
bun run start
bun test
bun run build