About cc-sessions-viewer
A native desktop browser for Claude Code, Codex, and Gemini CLI — read, search, and manage local session transcripts from all three in one place.
Faithful replay — thinking chains, tool-call pairings, structured diffs, inline screenshots.
Fast search — cross-project global hit (⌘⇧F) jumps to the exact message; one-click resume in Terminal.
Deep stats — aggregate token spend and cost; slice by project, model, or tool.
Read-only safety — original JSONL is never touched; delete is a move to shared trash, never rm.
Flexible export — single session or batches to offline-readable Markdown or HTML.
Features
- 🗂 Unified project view — group sessions by working directory across both CLIs
- 💬 Faithful chat replay — text, thinking blocks, tool calls, structured diffs, inline images
- 🔎 In-session search with scope — search across the whole conversation or scope to user messages, agent replies (incl. edits), or tool noise; prev / next jump + match counter
- 🌐 Global search (⌘⇧F / Ctrl+Shift+F) — Algolia-style overlay over the current agent, scoped to session titles and your own messages; click a hit to jump straight to that message with a flash highlight; recent queries with single-item removal
- 🔃 Session list search & sort — keyword search runs on the Rust side, matching session titles and your message text (cancellable mid-typing); sort by recency / size / message count, or show only ones with an ID
- 🪗 Collapse / expand all tool calls — one click to hide tool-call clutter and focus on the conversation
- 📤 Export session — save a single session to Markdown or HTML (native Save-As, offline-renderable HTML with inlined avatars / styles)
- 🧰 Multi-select & batch ops — pick sessions in bulk to move them to the trash or export them into a single export-YYYYMMDD-HHMMSS-{md,html}/ folder
- 🔄 Resume or start fresh — open Terminal in a project to resume an existing session (claude --resume <id> / codex resume <id>) or start a brand-new one
- 📡 Live tail — opened session auto-refreshes as the CLI appends new messages; an "● Live" indicator shows the watcher is active, and a "N new ↓" pill surfaces additions when you've scrolled up
- 🗑 Shared trash — soft-delete, preview a deleted session's transcript, restore one or many (multi-select); survives across both agents
- 🏠 Welcome screen — recently opened projects per agent with one-click reopen + per-entry removal
- 📌 Pin / sink projects — color-coded pins on the sidebar; sunk projects go to the bottom
- ✏️ Rename sessions — your new title syncs back to the CLI, so claude / codex resume pickers show it too
- 🌗 Light / dark / system theme — Codex-inspired neutral palette with brand-color accents
- 🌐 i18n with auto-detect — English / 简体中文 / 繁體中文 / 日本語；first launch matches the OS language, falls back to English
- ⚡️ Custom tooltip & agent brand icons — no out-of-place native chrome
- 🖼 Image lightbox for screenshots embedded in transcripts
