Welcome to traqo

traqo records what your LLM application does — every API call, tool use, and decision — as structured trace files.

Navigating

Folders group related traces. Click a folder to see what's inside. Use the breadcrumb path at the top to go back.

Traces are individual runs of your application. Click one to see every step it took.

Inside a trace

The left panel shows the span tree — a timeline of operations your app performed. Each span is one step (an LLM call, a tool invocation, etc).

Click any span to see its input, output, token usage, and timing in the right panel.

What the colors mean

llm LLM / model call
tool Tool or function call
ok Completed successfully
error Something went wrong

What the numbers mean

in / out Input / output tokens (LLM usage)
spans Number of operations in a trace
duration Wall-clock time

Keyboard shortcuts

Esc Go back / close dialog
? Toggle this help guide
↑ / ↓ Navigate spans in trace view
r Refresh trace list

Tips

Use Search to filter by name, tags, or thread ID. Use Status to show only errors.

Organize traces into folders by choosing your file path: Tracer(Path("traces/my-agent/run.jsonl"))

Select a span to view details