A zero-dependency HTML page that visualizes agent-trace JSONL files. Drag-drop a trace, see a step-by-step timeline with screenshots, antibot events, and LLM token totals.
Open index.html in any browser. Drag-drop a JSONL trace, or click Load sample.
git clone https://github.com/gotcs108/agent-viewer.git
open agent-viewer/index.htmlOr just download the single file — it's self-contained.
Hosted on GitHub Pages: https://gotcs108.github.io/agent-viewer/
The agent-trace CLI gives you print() output. That's fine for grep, hard for non-technical stakeholders. This page is the same data, rendered for someone who wants to look at one specific session and answer "what went wrong?" in 30 seconds.
Files are read locally via FileReader. Nothing is uploaded.
- Single
index.html, < 400 lines, no build step, no dependencies - Parser handles JSONL (one JSON object per line) — drops malformed trailing line if the trace crashed mid-write
- Renders: session header, totals strip, per-step accordion with semantic colors (antibot in orange, login_failed in red, login_success in green)
- Screenshots are loaded by relative path — if you serve the viewer from the trace's directory, they show inline
- Side-by-side mode: two traces, diff their steps (great for "main vs. PR branch" agent regressions)
- Antibot heat-map across many sessions: drop a folder, see which vendors are blocking which fraction of runs
- Direct link from agent-trace CLI:
agent-trace view <session-id>opens this page with the trace pre-loaded
MIT.