TUI Guide
The interactive terminal dashboard for monitoring and managing your task graph.
Launching
wg tui # default 2s refresh
wg tui --refresh-rate 1000 # 1s refreshViews
The TUI has three main views:
Dashboard
Split-pane view showing tasks (left) and agents (right) with status bars.
Use Tab to switch between panels, j/k to scroll,
and Enter to drill into a selected item.
Graph Explorer
Tree view of the dependency graph showing task status and active agent
indicators. Press g from the dashboard to open it. Supports
tree and graph view modes (toggle with d), search
(/), and subtree collapse/expand (h/l).
Log Viewer
Real-time tailing of agent output with auto-scroll. Jump to top with
g (disables auto-scroll) and back to bottom with
G (re-enables auto-scroll).
Inspector panel
Nine tabbed views accessible via Alt+Left / Alt+Right
(with slide animation):
| Tab | Content |
|---|---|
| Chat | Conversation with agents |
| Detail | Full task details with markdown rendering |
| Log | Task log entries |
| Messages | Inter-agent messages |
| Agency | Agent identity and performance |
| Config | Service configuration |
| Files | Task artifacts |
| Coordinator Log | Coordinator activity |
| Firehose | Combined live stream of all agent activity |
Resize the inspector with i (cycle: 1/3 → 1/2 → 2/3 → full)
and I (shrink back).
Status bar
- Service health badge — colored dot (green/yellow/red) with tap-to-inspect
- Token display — novel vs cached input split per task
- Lifecycle indicators — Unicode symbols for agency phases (assigning, evaluating, validating, verifying)
Keybindings
Global
| Key | Action |
|---|---|
q | Quit |
? | Show help overlay |
Esc | Back / close overlay |
Dashboard
| Key | Action |
|---|---|
Tab / Shift+Tab | Switch panel (Tasks / Agents) |
j/k or arrows | Scroll up / down |
Enter | Drill into selected item |
g | Open graph explorer |
r | Refresh data |
Graph Explorer
| Key | Action |
|---|---|
j/k or arrows | Navigate up / down |
h/l or arrows | Collapse / expand subtree |
d | Toggle tree / graph view |
Enter | View details or jump to agent log |
a | Cycle to next active agent task |
/ | Open search |
n / N | Next / previous match |
r | Refresh graph |
Log Viewer
| Key | Action |
|---|---|
j/k or arrows | Scroll one line |
PageDown / PageUp | Scroll half viewport |
g | Jump to top (disable auto-scroll) |
G | Jump to bottom (enable auto-scroll) |