https://github.com/kamranahmedse/claude-run
A beautiful web UI for browsing Claude Code conversation history.
https://github.com/kamranahmedse/claude-run
Last synced: 4 months ago
JSON representation
A beautiful web UI for browsing Claude Code conversation history.
- Host: GitHub
- URL: https://github.com/kamranahmedse/claude-run
- Owner: kamranahmedse
- License: mit
- Created: 2025-12-31T22:00:52.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-23T19:14:04.000Z (4 months ago)
- Last Synced: 2026-02-24T01:57:18.781Z (4 months ago)
- Language: TypeScript
- Size: 79 MB
- Stars: 519
- Watchers: 6
- Forks: 62
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-claude-code - **claude-run**
README
# Claude Run
Browse your Claude Code conversation history in a beautiful web UI
[](https://www.npmjs.com/package/claude-run)
[](https://opensource.org/licenses/MIT)
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