Claude Code History Viewer CLI
claude-code-history-viewer
A desktop app for browsing, searching and analyzing conversation history from Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, Aider and other agents
- 2,244 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads conversation history that may hold secrets
- Builds are downloaded from the Releases page
Install
- Works in
Manual install
brew install --cask jhlee0409/tap/claude-code-history-viewerFor Windows and Linux builds are on the Releases page. Do not mix manual installation and Homebrew.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads conversation history that may hold secrets
- Builds are downloaded from the Releases page
This is third-party code. Review the repository files before installing.
What it does
The app reads local conversation history files of agents and lets you browse, search and analyze them. Claude Code, Gemini CLI, Antigravity, Codex CLI, Cline, Cursor, Aider, OpenCode and others are supported, with the full list in the README. There are builds for macOS (a universal dmg), Windows and Linux. Installation on macOS through Homebrew: `brew install --cask jhlee0409/tap/claude-code-history-viewer`, and the rest downloads from the Releases page. The README advises choosing one installation method and not mixing manual and Homebrew. Version 1.31.0 from 04.10.2026, MIT license.
Who it is for. For people who work with several coding agents and want to search past decisions and conversations in one window and not across file folders.
Good fit when
- You need to find a past conversation with an agent by a keyword
- You need to see the session history of Claude Code, Codex and Cursor in one app
- You need usage analysis from conversation history
Not a fit when
- You cannot run an app that reads history: conversations may hold secrets
- You need cloud sync of history: the app works locally
Example request
Find in the October conversation history where we discussed the choice of database for the payment service and show the conclusionLimitations
The app reads your conversation history with agents, which often holds keys, passwords and code, so do not show the screen or send an export. It works locally on the history files. Builds are downloaded from the Releases page: check the source and signature per the README. Do not mix manual installation and Homebrew.
How to disable. Remove the app (brew uninstall --cask claude-code-history-viewer or the usual program removal). The agents' history files stay in place.
FAQ
What does the app do?
It shows, searches and analyzes agents' conversation history from local files.
Which agents are supported?
Claude Code, Gemini CLI, Antigravity, Codex CLI, Cline, Cursor, Aider, OpenCode and others, with the full list in the README.
Is it safe?
It works locally but reads history that may hold secrets: do not show the screen or send an export.
Discussion
No questions or reviews yet.
Related
CLI toolscc-lens
Claude Code Lens (cc-lens)
Local Claude Code analytics: a dashboard of sessions, tokens, cost and projects from your ~/.claude data, no cloud
Local browsing, search and cost tracking for Claude Code, Codex and other agent sessions in one web UI
A Claude Code plugin that catches your corrections in chat and, after review, writes them into CLAUDE.md and AGENTS.md
A real-time terminal monitor for Claude Code usage: tokens, messages and cost in the five-hour window, with forecasts and export
Token and cost reports for Claude Code, Codex, Gemini CLI and other agents from local logs, by day, month and session
A Claude Code plugin that keeps memory across sessions in one local file, with no database, cloud or API keys
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Repository stars | Main difference |
|---|---|---|---|
| Claude Code History Viewer (this entry) | no | 2,244 | |
| Claude Code Tools | no | 2,015 | a set of utilities, skills and hooks for Claude Code and Codex |
| Trail of Bits Claude Code Config | no | 2,132 | Claude Code settings from Trail of Bits: sandbox, permissions, hooks |
| Claude Code Cheat Sheet | no | 1,921 | an author's cheat sheet with techniques and subagents |
README in short
The README describes a desktop app for browsing and analyzing the conversation history of several agents, builds for three systems and installation through Homebrew and Releases. MIT license.