TUI Guide
Master the Kavi operator console — a keyboard-driven terminal interface with 9 dedicated views
The Kavi operator console is a full-screen terminal interface built with Ink. It provides real-time visibility into your multi-agent session through 9 dedicated views, all driven by keyboard shortcuts.
Opening the Console
kavi open --goal "Your goal here"Or reattach to an existing session:
kavi resumeKey Concepts
- Activity-first: The console opens on the Activity view, showing your session as a linear progress log
- Keyboard-driven: Every action has a keyboard shortcut — no mouse needed
- Real-time sync: The TUI receives pushed snapshots from the daemon over a local RPC socket
- Attention markers: Tabs show markers when new results, approvals, or follow-up actions appear
Views at a Glance
| Key | View | Purpose |
|---|---|---|
1 | Activity | Linear session progress log |
2 | Results | Agent outputs and execution plan |
3 | Tasks | Task board with dependency graph |
4 | Recommendations | Handoff and integration suggestions |
5 | Approvals | Pending approval inbox |
6 | Claims | Path ownership hotspots |
7 | Decisions | Routing and approval audit trail |
8 | Messages | Peer-to-peer agent communication |
9 | Worktrees | Agent branch and file changes |