A desktop application for browsing and viewing your Claude chat history.
Download the latest release here.
- Browseable Session History: View all your Claude conversations organized by project.
- Full Message Details: Examine the stored JSON to see extra details about your chats.
- Full Tool Use: See the full input & response data for each tool use.
- Token Costs: See token cost per message.
- Analytics: Presents some basic analytics about your sessions and tool use.
The "Claude History" tool does not transmit or upload or share your data in any way. All the related data remains private and local to your machine.
To run the code locally:
-
Clone the repository:
git clone <repository-url> cd claude-history-tool
-
Install dependencies:
yarn install
-
Build the application:
yarn rebuild
-
(Optional) Copy
.env.sampleto.envand adjust as needed.
The project uses multiple services that can be managed with the included candle MCP tool:
-
Start TypeScript compiler (watches for changes):
yarn dev:main
-
Start the renderer development server (http://localhost:3447):
yarn dev:renderer
-
Start Electron in development mode:
yarn dev:electron
-
Start Storybook (http://localhost:3448):
yarn storybook
Run the test suite:
yarn testRun tests with UI:
yarn test:uiMIT License - see package.json for details