Show HN: Claude Code History Viewer for macOS

4 jackleee 4 7/3/2025, 9:32:45 PM github.com ↗
*Claude Code History Viewer – A macOS Desktop App for Reviewing Claude Code History at a Glance*

Hello everyone,

I have a habit of reviewing my coding history when working with AI. It's important to trace back and understand "how did I get to this result?"

Recently, while using Claude Code, I found it quite inconvenient to check the history in separate terminal tabs or editor windows. So I built a desktop app called *Claude Code History Viewer* using *Tauri + React + Rust*.

## Key Features & Highlights

* *Claude Code Conversation History Visualization* When you install Claude Code, conversation logs are typically stored in `/Users/{username}/.claude` folder on macOS in JSONL format, organized by project. This app reads that data and displays commit/session history at a glance, just like viewing chat history.

* *Richer Information Than Terminal* Visualizes much more data than what the terminal shows by default - including tree structures, detailed session breakdowns, code diffs, images, tool usage results, and more in various formats.

* *Statistics: Token Usage by Project/Session, Daily Consumption, etc.* View various metrics on a dashboard, including how many tokens were used per project or session, daily token consumption, and other analytics.

* *Automatic/Manual Folder Detection* Automatically detects the `.claude` folder by default, but allows manual specification if the folder doesn't exist or is in a different location. (Hidden folders can be shown in Finder with Shift + Cmd + .)

* *Fully Local Operation & Privacy Protection* All data is processed locally only and never transmitted externally.

* *Easy Installation & Usage* Ready to use right away with no registration or setup required.

## Development Motivation

The process of reviewing AI coding results is crucial, but the existing terminal/editor approach was too cumbersome. I felt the need for a tool to view Claude's conversation history: * More easily * More comprehensively * More intuitively

So I built it myself.

How to Download & Install: You can download the latest DMG file from the release notes at the link and install it directly on your macOS system.

## Additional Notes

* This is currently a *beta version*, so there may be bugs or missing features. I welcome honest feedback! * Open source (MIT license) - anyone can freely contribute to improvements.

*This is a working application that you can try right now.*

If you have any questions or ideas for improvements, please leave them in the comments!

Comments (4)

subeadia · 4h ago
The epidemic of clearly LLM-generated READMEs has to stop. The emoji bullets are killing me.
jackleee · 36m ago
Thanks for the feedback! I've revised the README to remove the emoji bullets and make it more natural. Please let me know if you notice any other areas that could be improved.
tarikozket · 7h ago
any screenshots or screen recordings of what the experience looks like?
jackleee · 35m ago
I've added screenshots and a demo to the README. You can see them there now! Thank you