JSONL Viewer v1.3.4: Inspecting Nested Codex Subagent Traces
Melvin Vivas · X video post · 2026-09-07 · 0:12 · 1,465 views · Open on X
Topics: AI Agents, Tool Use & MCP, LLMOps, Deployment & Monitoring, AI Dev Tools & Productivity · Level: intermediate
Summary
Melvin Vivas announces version 1.3.4 of his open-source JSONL Viewer, a tool for reading JSONL files such as agent trace logs. This release improves the traces viewer for OpenAI Codex sessions. Subagent traces now nest under the run that spawned them, and each turn shows its model and reasoning effort. The tool is useful if you need to debug multi-agent runs.
Key points
- JSONL Viewer v1.3.4 (GitHub repo donvito/jsonl-viewer) updates its traces viewer for agent session logs.
- Codex subagent traces now nest under the parent run that spawned them, so you see the full multi-agent run as one tree.
- Turns carry MAIN or SUBAGENT labels, so you can tell the orchestrator apart from its subagents.
- The MAIN agent's view shows subagent names, so you can see which subagent was called.
- You can move between parent and child traces.
- Each turn shows the model used and the reasoning effort setting, which helps with cost and quality debugging.
- Takeaway: in multi-agent systems, viewing traces as a tree with per-turn model metadata makes failures easier to find.
Resources mentioned
- JSONL Viewer v1.3.4 release (donvito/jsonl-viewer) · repo · github.com · free
Open-source JSONL file viewer with a traces viewer for agent sessions, including nested Codex subagent traces. - OpenAI Codex · tool · openai.com · paid · recommended by both Bashiri Smith & Melvin Vivas
OpenAI's coding agent. In the diagram it writes code, fixes review findings and drives the build loop. The creator also used it to make this video.
Also in: Developers moving from ChatGPT/Codex to Claude (Melvin Vivas on X · notes), Creator Opinion: Codex Is Still the Best at Computer Use (Melvin Vivas on X · notes), OpenAI Codex Ambassador applications are open (Melvin Vivas on X · notes), GPT-Live-1.1: Multilingual Voice Update for ChatGPT and Codex (Melvin Vivas on X · notes) and 264 more
More in AI Agents, Tool Use & MCP
- Measuring Codex Pro Runtime: Astra(low) + Luna(max) Subagents
- Codex Orchestrator Skill: Astra Orchestrates, Luna Subagents Execute
- Codex Orchestrator: Astra/Sol Orchestrator with Luna Subagents
- Cutting Codex Subagent Costs: Luna Orchestrator, Astra Reviewer
- Cutting Token Costs in Codex Orchestrator/Subagent Setups via config.toml
- Inspecting Coding-Agent Traces Live with JSONL Viewer (Codex, Claude Code)