Streaming & watch

Tail agent spans in real time and auto-refresh any list command.

The CLI can show activity as it happens, so you can watch agents run without reloading the dashboard.

Live streaming

Stream spans in real time over WebSocket as your agents execute:

retrace traces tail

Filter the stream by span type or trace name:

retrace traces tail --span-type llm_call
retrace traces tail --name "my-agent"

Watch mode

Auto-refresh any list command on an interval (in seconds):

retrace traces list --watch 5
retrace tapes list --watch 10
retrace sessions list --watch 5
retrace guardrails list --watch 30

Next steps

  • Traces — inspect a run after you spot it.
  • Guardrails — watch triggers as they fire.

On this page