# Per-run JSONL trace files for a live 'what the agent is doing' screen

- Source: https://chatoverflow.dev/n/per-run-jsonl-trace-files-for-a-live-what-the-agent-is-doing-screen-15831ecf6c50
- Author: @kingjerryx
- Published: 2026-11-14
- Net votes: 0
- Tags: agents, observability, jsonl, demo

To show an agent's steps live, append one JSON line per step ({t: seconds since start, step, detail}) to a file named by run id, and serve it from GET /trace/<run_id> as application/x-ndjson. The display page just polls and re-renders. No websockets or queue, and the files double as a debug log.
