OpenAI Launches Euphony to Visualize Complex Codex Agent Session Logs

OpenAIOpenAI

· Updated

OpenAI released Euphony, an open-source web tool that transforms raw JSON chat data and Codex logs into an interactive, readable interface. It enables developers to debug multi-step agent workflows by filtering metadata, visualizing tokenization, and rendering rich markdown directly in the browser.

OpenAI launched Euphony, an open-source web tool for visualizing structured chat data and Codex session logs. Users can load data via JSON pastes, local files, or public URLs to transform raw logs into a navigable view. It extends the company's work on persistent screen memory by providing a structured interface for reviewing agent history.

As autonomous engineering agents handle complex multi-file tasks, raw text logs become impossible to parse manually. Euphony fills this observability gap with a dedicated UI for inspecting tool calls. This is critical for auditing unattended Codex automations where developers must review long-running agent decisions after execution.

You can use Euphony to filter datasets using JMESPath or inspect model tokenization via the integrated o200k_harmony visualizer. The tool is available for free as a hosted web app or can be integrated into custom workflows via its open-source repository on GitHub.

View the full update on openai.github.io
OpenAI Developers
OpenAI Developers
@OpenAIDevs
X

Introducing Euphony, an open-source tool for visualizing chat data and Codex session logs. Paste in a public URL or upload a local file, and Euphony turns the raw data into an easy-to-browse view. It supports translation, filtering, editing, and more. https://t.co/KTbMOLEWxD

199retweets3klikes
View on X

Still wondering? A few quick answers below.

Euphony is a web-based interactive tool developed by OpenAI for visualizing and exploring structured chat data. It is specifically designed to handle Harmony chat data and Codex session logs, transforming raw JSON or JSONL files into a readable conversation view. Users can inspect metadata, render markdown, and share specific messages or conversations via links.

You can load data into Euphony in three ways: by pasting JSON or JSONL content directly from your clipboard, by choosing a local file from your computer, or by providing a public URL that serves JSON or JSONL data. Once loaded, the tool processes the raw data into an easy-to-browse interface for analysis and review.

Yes, Euphony is an open-source project hosted on GitHub. It provides portable and modular web components that developers can use to visualize structured chat data and Codex sessions in their own browsers. Being open source allows the community to inspect the code, contribute to its development, or host their own instances of the visualization tool.

Euphony includes advanced features like JMESPath filtering to query specific metadata, a token visualizer for the o200k_harmony tokenizer, and a focus mode to hide specific message roles like system or tool outputs. It also supports custom labels for evaluation annotations and can render HTML or markdown formulas directly within the chat bubbles for better readability.

Harmony is the data format and tokenization system that Euphony is designed to visualize. This format supports various message roles, including user, assistant, system, and developer, as well as complex content types like code blocks and tool calls. Euphony allows users to see how this data is serialized and tokenized using specific Harmony renderers and tokenizers.

Every HeadsUpAI update is written based on its original source and reviewed before it's published. Read our editorial standards →

OpenAI

See all AI news & updates from OpenAI →

Share this update