Sessions

A session groups related traces — for example, every run in a single multi-agent workflow. The sessions commands let you list sessions and inspect how their agents interacted.

List sessions

retrace sessions list
retrace sessions list --limit 20 --json

Inspect a session

retrace sessions get <session_id>
retrace sessions get <session_id> --json

Session graph

View the causal graph of agents and spans within a session:

retrace sessions get <session_id> --graph

The graph shows how control passed between agents and where each span fits in the run.

Next steps

• Traces — inspect individual runs within a session.
• Forks — branch from any span.