@endorhq/capsule
v1.0.0
Published
Interactive AI coding agent session inspector. Explore, export, and share AI agent sessions easily.
Downloads
197
Readme
AI coding agents don't make it easy to revisit past sessions, nor sharing them. Capsule is an interactive inspector that turns session logs into a browsable and explorable timeline.
Check tool results inline, understand subagent purpose, filter by message, and understand what actually happened. When you need a second pair of eyes, share a session as a GitHub Gist. Works with Claude Code, Codex, Copilot, and Gemini.
Use it online to quickly inspect a session or open a shared one. Or install the CLI to browse your local sessions, anonymize sensitive data, and share them via the built-in GitHub Gist integration.
Online
Open capsule.endor.dev and drag-and-drop a session file. Everything stays in your browser — no data is sent to any server.
You can point to a GitHub Gist to share it: capsule.endor.dev?gist=8f31b208160d8e5ccca3a6b9cca0ed7a
CLI
Use it directly with your preferred Node package manager:
npx @endorhq/capsule --help
# or pnpm
pnpm dlx @endorhq/capsule --helpThe CLI gives you three commands:
capsule — Share and view AI agent session logs
Usage:
capsule share [file] Publish a session to GitHub Gist
capsule export [file] Save a session to a local file
capsule serve [--port N] Start a local web viewer
Options:
--help, -h Show this help messageStart a local viewer
Run the web viewer locally on your machine:
npx @endorhq/capsule serve
# or pnpm
pnpm dlx @endorhq/capsule serveThis starts a local server at http://localhost:3123. Capsule auto-discovers sessions from all supported agents on your machine. You will be able to navigate through the different detected sessions for multiple AI agents. Use --port to change the port.
Share a session
Publish a session to a GitHub Gist and get a shareable viewer link on the capsule.endor.dev website:
npx @endorhq/capsule share
# or pnpm
pnpm dlx @endorhq/capsule shareCapsule auto-discovers sessions from all supported agents on your machine. Pick one, choose what to anonymize, and get a link like capsule.endor.dev?gist=abc123 you can send to your team.
You can also point it at a specific file:
npx @endorhq/capsule share path/to/session.jsonl
# or pnpm
pnpm dlx @endorhq/capsule share path/to/session.jsonlRequires the GitHub CLI (
gh) to be installed and authenticated.
Export a session
Discover and export a copy of a session to a local file. You can anonymize the session using the different supported options.
npx @endorhq/capsule export
# or pnpm
pnpm dlx @endorhq/capsule exportWhy Capsule?
AI coding agents generate rich conversation logs, but reviewing them is harder than it should be:
- 🔍 Auto-discovery. Capsule finds sessions across
~/.claude/,~/.codex/,~/.gemini/, and more — no matter where each agent stores them. - 📄 Readable timeline. Thousands of lines of raw JSON become a clean, browsable conversation with tool calls and metadata organized inline.
- 🖱️ Fully interactive. Filter, search, and collapse sections. Jump straight to the tool call that matters.
- 🔗 Easy sharing. Share a session as a GitHub Gist and send your team a viewer link in seconds.
Capsule solves this by giving you a single viewer that works with every major agent format. Upload a file or let the CLI find your sessions automatically. Browse the timeline, inspect tool calls, check token usage, and share a link when you need a second pair of eyes.
Supported Formats
| Agent | File Format | Discovery Path |
|-------|-------------|----------------|
| Claude Code | .jsonl | ~/.claude/projects/ |
| Codex (OpenAI) | .jsonl | ~/.codex/sessions/ |
| Copilot (GitHub) | .jsonl | ~/.copilot/session-state/ |
| Gemini (Google) | .json | ~/.gemini/tmp/ |
Format is auto-detected from file content. The CLI discovers sessions from all agents automatically.
Local Development
pnpm install
# Website
pnpm -C packages/web dev # Start dev server at localhost:5173
pnpm -C packages/web build # Build the web
# CLI
# Build first the web and copy to work on serve command
PUBLIC_DISTRIBUTION=local pnpm -C packages/web build # Build the web
# Copy it
cp -r ./packages/web/build ./packages/cli/web
# Commands
pnpm -C packages/cli dev # Run the CLI
pnpm -C packages/cli build # Build the CLIReport Issues
Found a bug or have a feature request? Please open an issue on GitHub. If the issue is realted to a session, we appreciate if you can share with us the session on the issue or privately on Discord.
Join the Community
We'd love to hear from you! Whether you have questions, feedback, or want to share what you're building with Rover, there are multiple ways to connect.
- Discord: Join our Discord spaceship for real-time discussions and help
- Twitter/X: Follow us @EndorHQ for updates and announcements
- Mastodon: Find us at @[email protected]
- Bluesky: Follow @endorhq.bsky.social
License
Capsule is open source software licensed under the Apache 2.0 License.
Built with ❤️ by the Endor team
We build tools to make AI coding agents better
