Run the project simply by executing

``bash
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:

`bash
npm install -g claude-run
`

Then run it from any directory:

`bash
claude-run
`

The browser will open automatically at http://localhost:12001, showing all your Claude Code conversations.

`bash
claude-run [options]

Options:
-V, --version Show version number
-p, --port Port to listen on (default: 12001)
-d, --dir 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

`bash


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