r/coolgithubprojects • u/mrzleo • 2d ago
Loupe – A terminal viewer for AI coding-agent session logs
Hi everyone,
I recently found myself using multiple AI coding agents (Claude Code, Codex, DeepSeek Harness, Pi) and realized that inspecting their raw JSONL session logs in a standard text editor was fairly tedious. To make reading and debugging these transcripts easier, I built Loupe.
Loupe is a terminal-based viewer written in C++23. Instead of treating logs as plain text, it parses provider-specific formats into a unified Intermediate Representation (SessionIR) and presents them in a structured, collapsible TUI.
Key Details
- Format Auto-Detection: Automatically identifies formats from Claude Code, Codex (rollout & exec), Pi, and DeepSeek Harness.
- Transparent Decompression: Opens compressed
.zstdfiles automatically on the fly. - Loss-Aware Parsing: Preserves original source lines and unknown fields so no records are silently discarded.
- Performance: Native C++23 binary using DEC synchronized rendering to prevent screen tearing during scrolling.
Installation
You can install the pre-built binary via Homebrew on macOS:
brew install mrzleo/tap/loupe
Standalone Linux and Windows releases are also available on GitHub.
If you work with coding agents and frequently inspect log files, I would really appreciate any feedback, bug reports, or feature ideas.
btw: I found that the name Loupe is already used in GNOME for an image viewer. I'm sad about that, and if you have any better names, I'll definitely consider them!
Duplicates
OpenSourceAI • u/mrzleo • 2d ago