Browse, search, resume and manage your AI coding sessions in one desktop app.
AI coding tools like Claude Code, Codex, Gemini CLI, and Qwen Code store session data locally, but there's no easy way to browse, search, or revisit past conversations. CC Session brings all your sessions together in one unified interface — view full conversation histories, search across all providers with full-text search, export records, and resume any session directly in your terminal.
- Unified view — All your AI coding sessions from multiple providers in one place
- Full-text search — Search across all session content with SQLite FTS5 (
⌘K) - Resume sessions — Jump back into any session in Terminal, iTerm2, Ghostty, Kitty, Warp, WezTerm, Alacritty, Windows Terminal, or PowerShell (
⇧⌘R) - Live watch — Auto-refreshes when active sessions update (
⌘L) - Rich rendering — Markdown, syntax highlighting, Mermaid diagrams, KaTeX math, inline images, structured tool call diffs
- Token usage — Per-message and session-level token counts with cache hit/write breakdown
- Export — JSON, Markdown, or self-contained HTML (dark mode, collapsible tools & thinking blocks)
- Session management — Rename, trash/restore, favorites, batch operations
- Auto-update — Built-in updater checks for new releases automatically
- Keyboard-driven — Full keyboard navigation (
?to see all shortcuts) - i18n — English / Chinese
- Blocked folders — Hide sessions from specific project directories
| Provider | Data Source | Format | Live Watch |
|---|---|---|---|
| Claude Code | ~/.claude/projects/**/*.jsonl |
JSONL | FS events |
| Codex CLI | ~/.codex/sessions/**/*.jsonl |
JSONL | FS events |
| Gemini CLI | ~/.gemini/tmp/*/chats/*.json |
JSON | FS events |
| Kimi CLI | ~/.kimi/sessions/**/*.jsonl |
JSONL | FS events |
| Cursor CLI | ~/.cursor/projects/*/agent-transcripts/**/*.jsonl |
JSONL | FS events |
| OpenCode | ~/.local/share/opencode/opencode.db |
SQLite | Polling |
| Qwen Code | ~/.qwen/projects/*/chats/*.jsonl |
JSONL | FS events |
| CC-Mirror | ~/.cc-mirror/{variant}/config/projects/**/*.jsonl |
JSONL | FS events |
Each provider parses: messages, tool calls (with input/output), thinking/reasoning blocks, token usage, and inline images.
Download the latest release from Releases:
- macOS —
.dmg - Windows —
.exe(NSIS installer) - Linux —
.deb/.AppImage
macOS Gatekeeper: The app is not code-signed. On first launch, macOS may block it. Fix with:
xattr -cr /Applications/CC Session.app
⌘ = Cmd (macOS) / Ctrl (Windows & Linux)
| Key | Action |
|---|---|
⌘K |
Search |
⌘1-9 |
Switch tab |
⌘W / ⇧⌘W |
Close tab / Close all |
⌘] / ⌘[ |
Next / Prev tab |
⇧⌘R |
Resume in terminal |
⇧⌘E |
Export |
⌘B |
Toggle favorite |
⌘L |
Toggle live watch |
⌘⌫ |
Delete session |
⌘F |
Find in session |
? |
Show all shortcuts |
Requires Rust and Node.js 18+.
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
npx tsc --noEmit # Type-check frontend
cd src-tauri && cargo clippy # Lint Rust