The Live TUI

tael live opens an interactive terminal UI on top of the same data the CLI queries: a live-updating trace feed, per-service health, a waterfall visualizer for individual traces, and an eval progress view. It's the one place in Tael built for a human to watch rather than an agent to parse.

tael live

Flags

Name
--service
Type
string
Description
Filter the feed to a single service.
Name
--status
Type
ok | error | unset
Description
Filter the feed by span status.
Name
--interval
Type
seconds (default 2)
Description
How often the feed polls the server for new data.
Name
--evals
Type
flag
Description
Open the eval progress view instead of the trace feed.
Name
--eval-run
Type
run_id
Description
Open a specific eval run in the eval progress view.

tael live --service api-gateway
tael live --status error --interval 1
tael live --evals

Keyboard controls

Key	Action
`1` / `2` / `3`	Switch between Traces / Services / Evals tabs
`j` / `k`	Move down / up the list
`Enter`	Open the trace waterfall visualizer
`Esc` / `Backspace`	Go back
`c`	Add a comment (in trace view)
`Space`	Pause / resume live updates
`f`	Toggle failures/regressions only (evals)
`s`	Cycle sort: case ID, score, duration, cost, status (evals)
`r`	Refresh immediately
`Tab`	Move focus between panes
`q`	Quit

The c shortcut writes a trace comment — the same annotation an agent would add with tael comment add. Notes you leave in the TUI are visible to anything else querying that trace.

When to use it

The TUI is for humans watching a system in motion — during a deploy, while reproducing a bug, or while an eval suite runs. For programmatic monitoring (an agent watching for regressions), use tael watch instead, which prints signed deltas as plain JSON on an interval.