Skip to content

endorhq/capsule

Repository files navigation

Endor logo

Capsule

Made by Endor NPM version License Join our Discord

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.

Capsule session viewer

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 --help

The 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 message

Start a local viewer

Run the web viewer locally on your machine:

npx @endorhq/capsule serve
# or pnpm
pnpm dlx @endorhq/capsule serve

This 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.

Capsule local session picker

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 share

Capsule 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.

Share process with the CLI

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.jsonl

Requires 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 export

Why 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 CLI

Report 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.

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

About

Capsule is an interactive inspector that turns session logs into a browsable and explorable timeline.

Topics

Resources

License

Stars

Watchers

Forks

Contributors