A polished, web-based interface for efficiently browsing and managing Claude Code conversation history. It is designed for developers and power users who need to quickly search, filter, and revisit past interactions with Claude, providing real-time updates and seamless session resumption capabilities to enhance productivity.

How It Works

The tool operates by reading Claude Code's local conversation history, typically stored in ~/.claude. It parses these files to construct a navigable web UI, presenting conversations chronologically and allowing users to filter by project. Key architectural choices include utilizing Server-Sent Events (SSE) for live streaming of responses and generating copyable commands to resume sessions directly in the terminal, offering a significant usability improvement over raw log files.

Quick Start & Requirements

• Primary Install/Run: Execute npx claude-run directly for immediate use, or install globally via npm install -g claude-run and then run claude-run. The browser will automatically open to http://localhost:12001.
• Prerequisites: Node.js version 20 or higher is mandatory. Claude Code must be installed and have been used at least once to populate the necessary history files.
• Setup: Minimal setup; runs locally with no external dependencies beyond Node.js and Claude Code history.
• Links: Project repository: https://github.com/kamranahmedse/claude-run

Highlighted Details

• Real-time Streaming: Conversations update live as Claude generates responses via SSE.
• Search & Filter: Efficiently find sessions using prompt text or filter by project name.
• Session Resume: Easily copy terminal commands to continue any past conversation.
• User Experience: Features a clean, familiar chat interface, a collapsible sidebar for maximizing screen real estate, and a dark mode option.

Maintenance & Community

The project is developed and maintained by Kamran Ahmed. The README does not specify details regarding community channels (e.g., Discord, Slack), active contributors beyond the primary author, or a public roadmap.

Licensing & Compatibility

• License: MIT License.
• Compatibility: The permissive MIT license permits commercial use and integration within closed-source applications without significant restrictions.

Limitations & Caveats

Requires Claude Code to be installed and have generated conversation history files in the default ~/.claude directory. Functionality is directly tied to the presence and format of these local history files. No explicit support mentioned for alternative history storage locations or older Node.js versions.