Sessions Viewer
English · 中文 · 日本語 · Documentation · CHANGELOG
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 supported recorded context, 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, inspect cached MCP context estimates, and preview file edits. Review hook commands before testing: a dry-run executes the script, not a sandbox.
→ Read the tool management guide
Read and find context
- Recorded context — view supported thinking blocks, paired tools, structured diffs and recorded images; coverage depends on the source format.
- Global search — with
⌘⇧F, search titles and saved user prompts across the selected agent's projects, or switch to session-ID mode. Assistant answers and tool output are not matched.
- 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. Restart can restore tab titles/directories with a new shell, not the previous process or running command.
- 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 recorded token usage and estimated cost by project, model, or tool using cached models.dev prices; macOS menu bar stats show Today / 7d / 30d totals where usage is available. Estimates are not provider invoices.
- Flexible export — save Markdown, HTML, or parsed-message JSON. Remote or unreadable local images may remain linked; keep native files for a complete backup.
- Read-only browsing — reading, searching and exporting do not rewrite source transcripts. Rename, trash/restore, continuation and editing are separate write operations.
History processing is local; the whole app is not network-free. Online chat/resume uses your configured CLI/provider, and updates, prices and quota features can make requests. See privacy and data handling.
Supported session sources
Claude Code, Codex, Grok Build, Kimi Code, Pi, Antigravity CLI, and opencode. All seven provide history, search, export and terminal resume. In-app chat is available only for Claude Code and Codex. Usage statistics depend on recorded fields; the supported Antigravity transcript has none.
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/.
Task guides: Claude Code history · Codex rollouts · compatibility and synthetic samples · project and maintenance.
Screenshots
Install
Grab the latest installer from Releases, or follow the installation guide:
| 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."
Apple has not verified this build; the warning does not prove the download is safe.
Only proceed if you deliberately obtained and trust the installer from this project's Releases.
macOS 15 Sequoia and later — Control-click → Open no longer works, Apple removed
that bypass:
- Double-click the app once and dismiss the warning.
- Open System Settings → Privacy & Security and scroll to the bottom.
- Next to "Sessions Viewer" was blocked, click Open Anyway and authenticate.
- 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.
From Terminal, only for a trusted download: this removes the quarantine attribute
and bypasses that Gatekeeper check. Prefer the System Settings flow above.
xattr -dr com.apple.quarantine "/Applications/Sessions Viewer.app"
If it reports Operation not permitted, check ownership and installation location instead of blindly elevating permissions.
On Linux the .AppImage is portable — chmod +x and run. The .deb installs with:
sudo apt install ./cc-sessions-viewer_<ver>_amd64.deb
Development
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: latest Node 22, Rust stable. See CLAUDE.md for architecture notes.
Contributing
PRs welcome. Please use Conventional Commits (feat:, fix:, docs:, ...).
Star History
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 (Recommended · Zero fees)
License
MIT © jerrywu001 · @jerrywu185
Friend link: linux.do
