- Category
- Developer Tools
- Rank
- No. 1067Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- openai
- GitHub
- 422 stars
- Date
About
Browser viewer for inspecting harmony chat data and Codex agent sessions.
What it does
Euphony turns structured conversations and Codex event logs into readable browser timelines. It accepts pasted data, local JSON or JSONL files, and public web URLs, then detects conversations, sessions, or raw objects. Grid, editor, filtering, focus, metadata, token, and translation views support closer inspection.
Why it's ranked here
This is a focused inspection tool with unusually broad input handling and useful depth. Automatic session conversion, metadata exposure, JMESPath filtering, direct JSONL editing, and embeddable components make it practical for evaluation and agent work. The local-only backend warning and browser mode’s input cap keep the verdict measured.
What's good
The same interface handles Harmony conversations, Codex sessions, and otherwise unrecognized JSON objects. Markdown passes through sanitization, while enabled HTML previews run inside sandboxed frames. Codex parsing recognizes messages, reasoning, tool calls, outputs, session context, and patches. Framework-neutral custom elements can also be styled through CSS variables.
Tradeoffs
Frontend-only processing reads at most 100 JSONL lines, so large datasets need the optional local backend. That backend fetches remote URLs and carries an explicit SSRF warning against external hosting. Translation requires either backend support or a user-provided OpenAI API key. The library must be built before integration.
How to use it well
Use Euphony when training, evaluation, or agent debugging requires fast visual inspection of structured transcripts. Start with the hosted app for pasted, local, or public data, then embed its custom elements when the view belongs inside another web application. It does not replace secure production data ingestion or a hosted backend for large private datasets.
Technical notes+
package.json defines a public ESM package, TypeScript declarations, Vite builds, and pnpm tooling. src/euphony.ts exports conversation, message, Codex-session, utility, and type modules. src/utils/api-manager.ts implements browser and FastAPI-assisted loading, JMESPath filtering, and a 100-line frontend limit. src/utils/codex-session.ts detects and converts Codex event streams while omitting encrypted content from copied metadata. src/utils/utils.ts sanitizes rendered Markdown with DOMPurify and places optional HTML previews in sandboxed iframes. pyproject.toml declares the FastAPI server dependencies and strict mypy configuration.
Observed
- License
- Apache 2.0, with an included Prism-derived stylesheet remaining under MIT terms.
- Primary implementation
- TypeScript browser frontend built with Lit and Vite, plus an optional Python FastAPI server.
- Packaging
- Public ESM JavaScript package with bundled TypeScript declarations and pnpm-based build scripts.
- Interfaces
- Standalone browser application and embeddable framework-neutral Web Components.
- Input surface
- Clipboard, local JSON or JSONL files, and public HTTP(S) JSON or JSONL URLs.
- Platform support
- Frontend-only static hosting or backend-assisted local development.
Read from README.md, package.json, pyproject.toml, src/euphony.ts, src/vite-env.d.ts, src/utils/utils.ts, src/config/config.ts, src/utils/api-manager.ts, src/types/common-types.ts, src/types/harmony-types.ts, src/utils/codex-session.ts, src/utils/patch-preview.ts, src/utils/harmony-render.ts, src/utils/dompurify-configs.ts, src/utils/marked-katex-extension.ts.
What it can do
View harmony chat data
Harmony chat data files → Visual display of chat conversations and messages
Inspect Codex agent sessions
Codex agent session data → Detailed view of agent interactions and responses
Browse chat history
Chat log files → Chronological timeline of chat interactions
Analyze agent performance data
Codex session logs → Performance metrics and session analytics
Search through chat conversations
Search query and chat data → Filtered results of matching messages or sessions
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.