Run the project simply by executing
The browser will open automatically at http://localhost:12001.
Features
- Real-time streaming - Watch conversations update live as Claude responds
- Search - Find sessions by prompt text or project name
- Filter by project - Focus on specific projects
- Resume sessions - Copy the resume command to continue any conversation in your terminal
- Collapsible sidebar - Maximize your viewing area
- Dark mode - Easy on the eyes
- Clean UI - Familiar chat interface with collapsible tool calls
Usage
Install globally via npm:
npm install -g claude-run
Then run it from any directory:
The browser will open automatically at http://localhost:12001, showing all your Claude Code conversations.
claude-run [options] Options: -V, --version Show version number -p, --port <number> Port to listen on (default: 12001) -d, --dir <path> Claude directory (default: ~/.claude) --no-open Do not open browser automatically -h, --help Show help
How It Works
Claude Code stores conversation history in ~/.claude/. This tool reads that data and presents it in a web interface with:
- Session list - All your conversations, sorted by recency
- Project filter - Focus on a specific project
- Conversation view - Full message history with tool calls
- Session header - Shows conversation title, project name, and timestamp
- Resume command - Copies the command to resume the conversation
- Real-time updates - SSE streaming for live conversations
Requirements
- Node.js 20+
- Claude Code installed and used at least once
Development
# Clone the repo git clone https://github.com/kamranahmedse/claude-run.git cd claude-run # Install dependencies pnpm install # Start development servers pnpm dev # Build for production pnpm build
License
MIT © Kamran Ahmed