Show HN: Claude Code History Viewer for macOS

2 jackleee 1 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 (1)

tarikozket · 9m ago
any screenshots or screen recordings of what the experience looks like?