One desktop app to browse, search, resume, and manage all your AI coding sessions.
Claude Code, Codex, Antigravity, Kimi Code, Cursor CLI, Pi, and more all store their session data locally — but each in its own format, in its own folder, with no way to look back. CC Session brings every provider together in one fast, native app: read full conversation histories, search across all of them at once, export clean archives, and jump straight back into any session in your terminal.
💡 One window for every local coding session — no more digging through
~/.claude,~/.codex, and a dozen other folders.
- 🗂️ Unified view — every session from every supported provider, in one explorer
- 🔍 Full-text search — instant search across all session content (SQLite FTS5), plus in-session find
- ↩️ Resume in one click — drop straight back into any session in your terminal
- 📊 Usage analytics — cost, token, and per-model breakdowns with cache hit/write detail
- 🎨 Rich rendering — Markdown, syntax highlighting, Mermaid diagrams, KaTeX math, inline images, and structured tool-call diffs
- 👀 Live watch — file-based providers auto-refresh via OS watchers; OpenCode uses provider-aware polling
- 📤 Export — JSON, Markdown, or a self-contained HTML file (dark mode, collapsible tools & thinking blocks)
- 🗃️ Session management — rename, favorite, trash/restore, and batch operations
- ⌨️ Keyboard-first — navigate and act without touching the mouse
- 🔄 Auto-update, 🌐 English / 中文, and 🚫 blocked folders to hide noisy projects
Track exactly what you're spending across every provider — daily cost trends, per-model token totals, and cache efficiency, all in one dashboard.
| Provider | Source format | Live watch | Resume |
|---|---|---|---|
| Claude Code | JSONL | FS | claude --resume |
| Codex CLI | JSONL | FS | codex resume |
| Antigravity | JSONL | FS | agy --conversation |
| Kimi Code | JSONL | FS | kimi --session |
| Cursor CLI | JSONL + SQLite | FS | cursor agent --resume |
| OpenCode | SQLite | Poll | opencode -s |
| CC-Mirror | JSONL | FS | per-variant |
| Pi | JSONL | FS | pi --session |
Across providers, CC Session parses messages, tool calls, thinking/reasoning blocks, token usage, inline images, Markdown, Mermaid diagrams, and KaTeX math wherever the source format supports them — including subagent/child sessions.
Grab the latest build from Releases:
| Platform | File |
|---|---|
| macOS | .dmg |
| Windows | .exe (NSIS installer) |
| Linux | .deb / .AppImage |
macOS Gatekeeper: the app isn't code-signed, so macOS may block it on first launch. Clear the quarantine flag:
xattr -cr "/Applications/CC Session.app"
- Install and open CC Session
- Let it index your local provider data
- Browse a session, search across your history, or resume right where you left off
Requires Rust and Node.js 20+.
git clone https://github.com/tyql688/cc-session.git
cd cc-session
npm install
npm run tauri build # Production build
npx tauri build --bundles dmg # DMG onlynpm run tauri dev # Dev with hot reload
npm run check # Type-check + Biome + ESLint (frontend)
npm test # Frontend tests (Vitest)
cd src-tauri && cargo test # Rust tests
cd src-tauri && cargo clippy --all-targets --all-features -- -D warningsCode style is documented in style/ts.md and style/rust.md, enforced by Biome, ESLint, Clippy, and a lefthook pre-commit hook. On macOS, file-based live watch uses the notify crate's kqueue backend for more reliable file-level updates.
- Tauri 2 — desktop shell and native integrations
- SolidJS — reactive frontend UI
- Rust — provider parsing, indexing, export, and session lifecycle
- SQLite + FTS5 — local storage and full-text search
- Vitest, Biome, ESLint, and Clippy — testing and code quality
MIT © tyql688