Claude Run

Browse your Claude Code conversation history in a beautiful web UI

Run the project simply by executing

npx claude-run

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:

claude-run

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