{"id":35893256,"url":"https://github.com/kamranahmedse/claude-run","last_synced_at":"2026-02-24T02:25:24.266Z","repository":{"id":331270095,"uuid":"1126016135","full_name":"kamranahmedse/claude-run","owner":"kamranahmedse","description":"A beautiful web UI for browsing Claude Code conversation history.","archived":false,"fork":false,"pushed_at":"2026-02-23T19:14:04.000Z","size":82845,"stargazers_count":519,"open_issues_count":4,"forks_count":62,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-02-24T01:57:18.781Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kamranahmedse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-31T22:00:52.000Z","updated_at":"2026-02-23T19:14:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kamranahmedse/claude-run","commit_stats":null,"previous_names":["kamranahmedse/claude-run"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kamranahmedse/claude-run","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamranahmedse%2Fclaude-run","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamranahmedse%2Fclaude-run/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamranahmedse%2Fclaude-run/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamranahmedse%2Fclaude-run/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kamranahmedse","download_url":"https://codeload.github.com/kamranahmedse/claude-run/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamranahmedse%2Fclaude-run/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29769164,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T01:40:24.820Z","status":"online","status_checked_at":"2026-02-24T02:00:07.497Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-09T11:00:36.029Z","updated_at":"2026-02-24T02:25:19.250Z","avatar_url":"https://github.com/kamranahmedse.png","language":"TypeScript","funding_links":[],"categories":["GUIs \u0026 Web UIs","TypeScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Claude Run\n\nBrowse your Claude Code conversation history in a beautiful web UI\n\n[![npm version](https://img.shields.io/npm/v/claude-run.svg)](https://www.npmjs.com/package/claude-run)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n\u003cimg src=\".github/claude-run.gif\" alt=\"Claude Run Demo\" width=\"800\" /\u003e\n\n\u003c/div\u003e\n\n\u003cbr /\u003e\n\nRun the project simply by executing\n\n```bash\nnpx claude-run\n```\n\nThe browser will open automatically at http://localhost:12001.\n\n## Features\n\n- **Real-time streaming** - Watch conversations update live as Claude responds\n- **Search** - Find sessions by prompt text or project name\n- **Filter by project** - Focus on specific projects\n- **Resume sessions** - Copy the resume command to continue any conversation in your terminal\n- **Collapsible sidebar** - Maximize your viewing area\n- **Dark mode** - Easy on the eyes\n- **Clean UI** - Familiar chat interface with collapsible tool calls\n\n## Usage\n\nInstall globally via npm:\n\n```bash\nnpm install -g claude-run\n```\n\nThen run it from any directory:\n\n```bash\nclaude-run\n```\n\nThe browser will open automatically at http://localhost:12001, showing all your Claude Code conversations.\n\n```bash\nclaude-run [options]\n\nOptions:\n  -V, --version        Show version number\n  -p, --port \u003cnumber\u003e  Port to listen on (default: 12001)\n  -d, --dir \u003cpath\u003e     Claude directory (default: ~/.claude)\n  --no-open            Do not open browser automatically\n  -h, --help           Show help\n```\n\n## How It Works\n\nClaude Code stores conversation history in `~/.claude/`. This tool reads that data and presents it in a web interface with:\n\n- **Session list** - All your conversations, sorted by recency\n- **Project filter** - Focus on a specific project\n- **Conversation view** - Full message history with tool calls\n- **Session header** - Shows conversation title, project name, and timestamp\n- **Resume command** - Copies the command to resume the conversation\n- **Real-time updates** - SSE streaming for live conversations\n\n## Requirements\n\n- Node.js 20+\n- Claude Code installed and used at least once\n\n## Development\n\n```bash\n# Clone the repo\ngit clone https://github.com/kamranahmedse/claude-run.git\ncd claude-run\n\n# Install dependencies\npnpm install\n\n# Start development servers\npnpm dev\n\n# Build for production\npnpm build\n```\n\n## License\n\nMIT © Kamran Ahmed\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamranahmedse%2Fclaude-run","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkamranahmedse%2Fclaude-run","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamranahmedse%2Fclaude-run/lists"}