Skip to main content

tui

Launch the terminal UI dashboard.

Usage​

runix tui

Description​

Opens an interactive terminal dashboard built with BubbleTea. Shows a process table, log viewer, status bar, and keyboard shortcuts for managing processes.

The TUI communicates with the daemon if running, otherwise uses a direct supervisor instance.

Interface Layout​

┌──────────────────────────────────────────────┐
│  Runix Process Manager          v0.1.0       │
├──────┬──────────┬─────────┬────────┬─────────┤
│ ID   │ NAME     │ STATUS  │ PID    │ UPTIME  │
│ 1    │ api      │ running │ 48291  │ 5m      │
│ 2    │ worker   │ running │ 48292  │ 5m      │
│ 3    │ cron     │ stopped │ -      │ -       │
├──────┴──────────┴─────────┴────────┴─────────┤
│  Logs: api                                    │
│  2025-01-15 10:30:00 [out] Server started     │
│  2025-01-15 10:30:01 [out] Connected to db    │
│  ...                                          │
├──────────────────────────────────────────────┤
│  q:quit  ↑↓:nav  r:restart  s:stop  l:logs   │
└──────────────────────────────────────────────┘

Features​

  • Process table — View all processes with ID, name, status, PID, and uptime
  • Log viewer — View stdout/stderr for the selected process
  • Help view — Press ? to see all keybindings
  • Mouse support — Click to select processes

What's Next​