Skip to content
M31A

TUI Cockpit Manual

Terminal UI surfaces, navigation router, and RAII TerminalGuard.


The M31A interactive cockpit is implemented with ratatui 0.30 and crossterm 0.29, guarded by RAII raw-mode terminal restoration.

Cockpit Architecture

The cockpit contains 10 dedicated surface controllers: Mission Overview, Conversation Timeline, Task DAG Visualizer, Agent Swarm Pool, Tool Execution View, Verification Surface, Telemetry & Metrics, Git Attribution, Replay Controller, and Approval Coordinator.

Projection of Runtime Truth

The TUI does not maintain duplicate business logic. It is a strict read-only projection of authoritative SQLite runtime state. Without the governed runtime bridge, composer submissions fail closed with an explicit error rather than executing unmonitored code.

Key Navigation Commands

Tab
Cycle surfaces
1–9
Jump to surface
j / k
Scroll timeline
Enter
Expand card / detail
Esc
Focus composer
Ctrl+C
Clean cancellation