Skip to main content

Module tui

Module tui 

Source
Expand description

The observation deck.

A competition takes minutes of agent latency per node, across several runs at once. Watching that with magi show in a loop is the “walking the terminal tabs” problem the whole design exists to remove, so bare magi opens this instead: every run in one list, status in colour, the selected run’s full report beside it, refreshed from disk as the graph writes.

It is read-only on purpose. The runs are the record of what the agents did; a keystroke that could rewrite one belongs in an explicit subcommand (magi fold), not one j away from browsing.

§Structure

App is pure state with pure transitions, so the interesting behaviour — selection clamping, filter cycling, keeping the cursor on the same run across a refresh — is unit-testable without a terminal. draw is the only function that knows about ratatui, and [run] is the only one that touches the real terminal.

Structs§

App
TUI state.
Counts
Counts for the header.

Enums§

Filter
Which runs to show.
Focus
Which pane the keys move.

Functions§

draw
Render one frame.
event_loop
The loop, generic over the backend so a test can drive it.
run
Open the observation deck on the real terminal.