hun.shThe TUI
Your mission control center.
The Terminal User Interface (TUI) is the primary way to interact with hun. It acts as a global dashboard for all your projects.
Access it from anywhere by running:
hunIf you are already running projects, you will see their status.
If not, use the Project Switcher (p) to start one.
Why TUI First?
- Instant Feedback: See services go from
STARTINGtoRUNNING(orERROR) in real-time. - Unified Logs: see multiple services interleaving their logs without mixing them up.
- Zero Latency: No overhead of starting a new process just to check status.
Navigation
| Key | Action |
|---|---|
← / → | Switch active pane (Services / Logs) |
↑ / ↓ (j / k) | Move inside active pane |
Tab | Cycle projects in Multitask mode |
q | Quit TUI (services keep running) |
Actions
| Key | Action |
|---|---|
l (Logs pane) | Toggle Live mode |
w | Toggle log wrapping |
v | Start/reset line-range selection at cursor |
c | Copy current line or selected range |
y | Yank current line or selected range |
u / d | Fast log scroll (PgUp / PgDn also works) |
Home / End (g / G) | Jump to top/bottom logs |
r | Restart selected service |
R | Restart all services in project |
x | Stop selected service |
s | Stop focused project |
/ | Filter logs (search mode) |
a | Show combined logs from all services |
p | Project Switcher (fuzzy find) |
m | Switch to Multitask mode |
f | Switch to Focus mode (in Multitask) |
The Project Switcher (p)
Press p to open a fuzzy finder of all your registered projects.
- Select one and press
Enterto switch to it immediately. - If you are in Multitask mode, it will switch focus to that project in the UI.
Viewing Logs
When viewing logs:
- manual scrolling pauses live mode and shows unread count.
lresumes/toggles live mode.Shift + ↑/↓scrolls faster.vstarts selection at the current cursor and pauses live mode.- selection can be done with keyboard (
v+ arrows) or mouse (click / Shift+click). - when a selected service is stopped, logs pane shows a stopped-state view instead of stale log rows.
Mouse Support
- Click a project tab to focus it.
- Click a service to select it.
- Click in logs to set cursor.
- Shift+click in logs to extend selection range.
- Mouse wheel scrolls logs, services, and the picker list.