Skip to content

TUI

On an interactive terminal, evolve run triggers, run evals and run all open a full-screen TUI: first a selection form to scope the run, then a live dashboard that streams results as agents finish. Pass --no-tui (or set EVOLVE_NO_TUI=1) for the plain line-based output used in CI and non-TTY pipes — both paths drive the same engine, so the run is identical either way.

Selection form

The Evolve selection form

A set of focusable panes you tab between to choose what runs:

  • Filters — the same new / modified / failed scoping the run flags expose.
  • Harnesses — the agent CLIs to drive; any whose CLI is off PATH is shown disabled.
  • Models — individual models grouped under a per-provider header row, so you can toggle one model or a whole provider at once. Models unsupported by the enabled harnesses are shown disabled.
  • Plugins / Skills / Cases — a tree of every trigger and behavioral case. Each row shows whether it is forced on, forced off, or auto-queued for all / some / none of the enabled models; a legend under the tree names every glyph.
Keys Action
Tab / Shift+Tab Move left or right between panes
14 Jump straight to a pane
Up Down / J K Move up or down within a pane
Left Right / H L Collapse or expand the tree
Space Toggle the selected row
G / Shift+G Jump to top or bottom
R Start the run
Esc Quit without running

The form previews exactly what will execute — it and the engine resolve through the same plan, so they cannot drift.

Live dashboard

The Evolve live run dashboard

Once a run starts, the dashboard streams progress:

  • A title bar with running pass / fail / error tallies, elapsed time, rolled-up cost, and an overall progress bar.
  • An Execution tree (plugin → skill → model → case) carrying per-node rollup columns.
  • A tabbed Rollup (Summary / Providers / Plugins / Skills), a Runs log of every execution in plan order, and a Details pane showing in-flight cases and the selected case's authored spec.

Selecting a run in any pane moves the selection everywhere.

Keys Action
F Follow the live execution
Enter Open the selected run's detail
G / Shift+G Jump to top or bottom
Ctrl+D / Ctrl+U Scroll down or up a page

See DESIGN.md → TUI in the repo for the full wiring.