cc-sessions-viewer

<div align="center"> # Sessions Viewer [](https://github.com/jerrywu001/cc-sessions-viewer/releases) [](https://github.com/jerrywu001/cc-sessions-viewer) [](https://github.com/jerrywu001/cc-sessions-viewer/releases) [](https://tauri.app/) [](https://github.com/jerrywu001/cc-sessions-viewer/releases/latest) [](LICENSE) **English** · [中文](README.zh-CN.md) · [日本語](README.ja.md) · [**Documentation**](https://sessions-viewer.js-bridge.com) · [CHANGELOG](CHANGELOG.md) <p align="center">A native desktop browser for <strong>Claude Code</strong>, <strong>Codex</strong>, <strong>Grok Build</strong>, <strong>Kimi Code</strong>, <strong>Pi</strong>, <strong>Antigravity CLI</strong>, and <strong>opencode</strong>.<br/>Read, search, and manage local session transcripts from all seven in one place.</p> <p align="center">Plus a <strong>tool management</strong> page — round up the skills scattered across your agents (duplicates, dead links, the same one stored three times),<br/>and take over MCP servers, hooks, and instruction files. <a href="https://sessions-viewer.js-bridge.com/tools/"><strong>Guide →</strong></a></p> </div> https://github.com/user-attachments/assets/9bcb92a8-e5b8-40e5-b492-af252162309b --- ## What it does Sessions Viewer turns local agent transcripts into a searchable workspace. Open a project, inspect exactly what happened, then continue the work from the same place without manually hunting through JSONL files. > [!TIP] > **New — Tool management.** Skills, MCP servers, hooks, and instruction files for all seven agents in one place. Find the duplicate skills and broken links on your machine and repair them, see what your MCP servers cost in context before you type, and dry-run a hook before you trust it. Every change previews the exact file edits first. > > → **[Read the tool management guide](https://sessions-viewer.js-bridge.com/tools/)** ### Read and find context - **Faithful replay** — preserve thinking chains, tool-call pairings, structured diffs, and inline screenshots. - **Global search** — search across projects and jump to the exact matching message with `⌘⇧F`. - **Jump to prompt** — scan every user prompt in a compact list, then scroll and flash the selected message. - **Views history** — revisit recent read and chat views, with per-project search and favorites. ### Continue the work - **Built-in chat** — start or resume Claude Code and Codex sessions with model, reasoning-effort (including Opus **Ultracode**), and permission-mode controls. - **One-click resume** — open a session in an embedded terminal or in **Terminal.app**, **cmux**, **iTerm2**, **Ghostty**, or **Warp**. - **Shell tabs** — run regular shell commands beside agent sessions; tabs persist across restarts. - **Launch arguments** — configure per-agent CLI flags such as `--dangerously-skip-permissions` for new and resumed sessions. ### Keep projects organized - **Split panes** — arrange side-by-side or stacked panes, drag tabs between panes, and keep each project's layout across restarts. - **cmux integration** — reuse workspaces by working directory, find running sessions, choose smart split directions, and name tabs after directories. - **Bookmarks** — pin frequently used folders to the sidebar for quick access. - **Rename and trash** — sync session renames back to the CLI and soft-delete sessions with restore support. ### Understand usage and share results - **Stats and pricing** — inspect token spend and cost by project, model, or tool using live pricing from models.dev; macOS menu bar stats show Today / 7d / 30d totals per agent. - **Flexible export** — export one session or a batch as offline-readable Markdown, HTML, or lossless JSON. - **Read-only safety** — source JSONL files are never modified or removed. ### Supported session sources Claude Code, Codex, Grok Build, Kimi Code, Pi, Antigravity CLI, and opencode. Grok Build, Kimi Code, and Pi provide history, terminal, export, analysis, and resume workflows; their GUI chat is intentionally not included. Where each one stores its sessions on disk, with commands for reading a transcript by hand, is documented at [sessions-viewer.js-bridge.com/agents/](https://sessions-viewer.js-bridge.com/agents/). ## Screenshots <details> <summary>Open the visual tour</summary> <table> <tr> <td width="50%"> <img src="docs/screenshots/cover.png" alt="Main view — sidebar, sessions, and chat" /> <p align="center"><em>Main view — sidebar, sessions, chat</em></p> </td> <td width="50%"> <img src="docs/screenshots/chat.png" alt="Faithful replay — thinking, tool calls, structured diffs" /> <p align="center"><em>Faithful replay — thinking, tool calls, structured diffs</em></p> </td> </tr> <tr> <td width="50%"> <img src="docs/screenshots/split-screen.png" alt="Split panes — multiple sessions side by side" /> <p align="center"><em>Split panes — multiple sessions side by side, drag tabs between panes</em></p> </td> <td width="50%"> <img src="docs/screenshots/chat-preview.png" alt="In-app chat — Mermaid, tables, file mentions and image attachments" /> <p align="center"><em>In-app chat — Mermaid & tables, @-mention files, attach images</em></p> </td> </tr> <tr> <td width="50%"> <img src="docs/screenshots/session-resume.png" alt="Embedded terminal resume" /> <p align="center"><em>Embedded terminal — one-click resume or new session</em></p> </td> <td width="50%"> <img src="docs/screenshots/search.png" alt="Global search overlay" /> <p align="center"><em>Global search (⌘⇧F) jumps to the message</em></p> </td> </tr> <tr> <td width="50%"> <img src="docs/screenshots/stats.png" alt="Token & cost analytics" /> <p align="center"><em>Token & cost analytics by project, model, tool</em></p> </td> <td width="50%"> <img src="src/assets/sys-stats.png" alt="Menu bar stats — per-agent cost and token overview" /> <p align="center"><em>Menu bar stats — per-agent cost & token overview</em></p> </td> </tr> <tr> <td width="50%"> <img src="docs/screenshots/model-price.png" alt="Live model pricing table" /> <p align="center"><em>Live model pricing</em></p> </td> <td width="50%"> <img src="docs/screenshots/trash.png" alt="Shared trash with restore" /> <p align="center"><em>Shared trash — soft-delete with one-click restore</em></p> </td> </tr> <tr> <td width="50%"> <img src="src/assets/settings.png" alt="Settings — terminal picker and launch arguments" /> <p align="center"><em>Settings — terminal picker & launch arguments</em></p> </td> <td width="50%"> <img src="docs/screenshots/export.png" alt="Exported HTML preview" /> <p align="center"><em>Exported HTML — fully offline, opens in any browser</em></p> </td> </tr> </table> </details> ## Install Grab the latest installer from [Releases](https://github.com/jerrywu001/cc-sessions-viewer/releases), or follow the [installation guide](https://sessions-viewer.js-bridge.com/guide/install): | Platform | File | | --- | --- | | macOS (Apple Silicon + Intel) | `.dmg` | | Windows x64 | `-setup.exe` / `.msi` | | Linux x86_64 | `.deb` / `.AppImage` | > [!IMPORTANT] > **macOS: this build is not notarized.** It is ad-hoc signed, so Gatekeeper blocks the > first launch with *"Apple could not verify 'Sessions Viewer' is free of malware."* > That is what an unsigned open-source build looks like, not a sign something is wrong. > > **macOS 15 Sequoia and later** — Control-click → Open no longer works, Apple removed > that bypass: > 1. Double-click the app once and dismiss the warning. > 2. Open **System Settings → Privacy & Security** and scroll to the bottom. > 3. Next to *"Sessions Viewer" was blocked*, click **Open Anyway** and authenticate. > 4. Launch the app again and click **Open**. > > **macOS 14 Sonoma and earlier** — Control-click (right-click) the app in Finder → > **Open** → **Open** in the dialog. Once is enough. > > **Either version, from Terminal:** > ```bash > xattr -dr com.apple.quarantine "/Applications/Sessions Viewer.app" > ``` > Prefix with `sudo` if it reports `Operation not permitted`. On Linux the `.AppImage` is portable — `chmod +x` and run. The `.deb` installs with: ```bash sudo apt install ./cc-sessions-viewer_<ver>_amd64.deb ``` ## Development ```bash git clone https://github.com/jerrywu001/cc-sessions-viewer.git cd cc-sessions-viewer npm install npm run tauri dev # dev mode npm run tauri build # bundle ``` Prereqs: Node 20+, Rust stable. See [`CLAUDE.md`](CLAUDE.md) for architecture notes. ## Contributing PRs welcome. Please use [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `docs:`, ...). ## Star History <a href="https://www.star-history.com/?type=date&repos=jerrywu001/cc-sessions-viewer"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=jerrywu001/cc-sessions-viewer&type=date&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=jerrywu001/cc-sessions-viewer&type=date&legend=top-left" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=jerrywu001/cc-sessions-viewer&type=date&legend=top-left" /> </picture> </a> ## Sponsorship Support This project is maintained in my spare time. Sponsorship helps cover ongoing development, bug fixes, and documentation. - 🛠️ Continuous development and updates - 🐛 Swift bug fixes and issue resolution - 📚 Documentation improvements and expanded examples For custom work or other special requests, contact me through one of the sponsorship options below. Requests start at US$50 and depend on current availability. ### Ways to contribute: - GitHub Sponsors [GitHub Sponsors](https://github.com/sponsors/jerrywu001) (Recommended · Zero fees) - Alipay/Wechat <table style="display: flex; width: 500px;"> <tr> <td style="margin-right: 16px;"> <img style="width: 150px;" src="https://www.js-bridge.com/alipay.jpg" /> </td> <td style="margin-right: 16px;"> <img style="width: 150px;" src="https://www.js-bridge.com/wechat.jpg" /> </td> </tr> </table> ## License [MIT](LICENSE) © jerrywu001 · [@jerrywu185](https://x.com/jerrywu185) > Friend link: [linux.do](https://linux.do/)