{"id":43957508,"url":"https://github.com/op7418/codepilot","last_synced_at":"2026-04-02T15:30:59.059Z","repository":{"id":336864538,"uuid":"1151411061","full_name":"op7418/CodePilot","owner":"op7418","description":"A native desktop GUI for Claude Code — chat, code, and manage projects visually. Built with Electron + Next.js.","archived":false,"fork":false,"pushed_at":"2026-02-11T06:45:29.000Z","size":2998,"stargazers_count":1679,"open_issues_count":34,"forks_count":174,"subscribers_count":10,"default_branch":"main","last_synced_at":"2026-02-11T14:43:08.912Z","etag":null,"topics":["ai","anthropic","claude","claude-code","desktop-app","electron","gui","nextjs"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/op7418.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2026-02-06T12:38:55.000Z","updated_at":"2026-02-11T14:29:10.000Z","dependencies_parsed_at":"2026-02-10T08:03:37.685Z","dependency_job_id":null,"html_url":"https://github.com/op7418/CodePilot","commit_stats":null,"previous_names":["op7418/codepilot"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/op7418/CodePilot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/op7418%2FCodePilot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/op7418%2FCodePilot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/op7418%2FCodePilot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/op7418%2FCodePilot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/op7418","download_url":"https://codeload.github.com/op7418/CodePilot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/op7418%2FCodePilot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29363010,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T08:51:36.827Z","status":"ssl_error","status_checked_at":"2026-02-12T08:51:26.849Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai","anthropic","claude","claude-code","desktop-app","electron","gui","nextjs"],"created_at":"2026-02-07T05:02:24.988Z","updated_at":"2026-04-02T15:30:59.034Z","avatar_url":"https://github.com/op7418.png","language":"TypeScript","readme":"\u003cimg src=\"docs/icon-readme.png\" width=\"32\" height=\"32\" alt=\"CodePilot\" style=\"vertical-align: middle; margin-right: 8px;\" /\u003e CodePilot\n===\n\n**A unified desktop client for Claude Code** -- multi-provider support, MCP extensions, custom skills, cross-platform bridge, and an assistant workspace that understands your projects.\n\n[![GitHub release](https://img.shields.io/github/v/release/op7418/CodePilot)](https://github.com/op7418/CodePilot/releases)\n[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)](https://github.com/op7418/CodePilot/releases)\n[![License](https://img.shields.io/badge/license-BSL--1.1-orange)](LICENSE)\n\n[中文文档](./README_CN.md) | [日本語](./README_JA.md)\n\n![CodePilot](docs/screenshot.png)\n\n---\n\n[Download](#platform--installation) | [Quick Start](#quick-start) | [Documentation](#documentation) | [Contributing](#contributing) | [Community](#community)\n\n---\n\n## Why CodePilot\n\n**Multi-provider, one interface.** Connect to Anthropic, OpenRouter, Bedrock, Vertex, or any custom endpoint. Switch providers and models mid-conversation without losing context.\n\n**MCP + Skills extensibility.** Add MCP servers (stdio / sse / http) with runtime status monitoring. Define reusable prompt-based skills -- global or per-project -- and invoke them as slash commands. Browse and install community skills from skills.sh.\n\n**Control from anywhere.** Bridge connects CodePilot to Telegram, Feishu, Discord, and QQ. Send a message from your phone, get the response on your desktop.\n\n**An assistant that knows your project.** Set up a workspace directory with persona files (soul.md, user.md), rules (claude.md), and persistent memory (memory.md). Claude uses these to adapt to your project's conventions over time, with onboarding flows and daily check-ins.\n\n**Built for daily use.** Pause, resume, and rewind sessions to any checkpoint. Work in split-screen with two conversations side by side. Track token usage and costs. Import CLI session history. Switch between dark and light themes.\n\n---\n\n## Quick Start\n\n### Path A: Download a release (most users)\n\n1. Install the Claude Code CLI: `npm install -g @anthropic-ai/claude-code`\n2. Authenticate: `claude login`\n3. Download the installer for your platform from the [Releases](https://github.com/op7418/CodePilot/releases) page\n4. Launch CodePilot\n\n### Path B: Build from source (developers)\n\n| Prerequisite | Minimum version |\n|---|---|\n| Node.js | 18+ |\n| Claude Code CLI | Installed and authenticated |\n| npm | 9+ (ships with Node 18) |\n\n```bash\ngit clone https://github.com/op7418/CodePilot.git\ncd CodePilot\nnpm install\nnpm run dev              # browser mode at http://localhost:3000\n# -- or --\nnpm run electron:dev     # full desktop app\n```\n\n---\n\n## First Launch\n\n1. **Authenticate Claude** -- Run `claude login` in your terminal if you haven't already.\n2. **Configure a Provider** -- If you only use Anthropic via CLI authentication or `ANTHROPIC_API_KEY`, Providers setup is optional. For OpenRouter, Bedrock, Vertex, or custom endpoints, go to **Settings \u003e Providers** and add the credentials first.\n3. **Create a conversation** -- Pick a working directory, select a mode (Code / Plan / Ask), and choose a model.\n4. **Set up Assistant Workspace** (optional) -- Go to **Settings \u003e Assistant**, choose a workspace directory, and enable Onboarding. CodePilot creates `soul.md`, `user.md`, `claude.md`, and `memory.md` at the workspace root (state is tracked in the `.assistant/` subdirectory).\n5. **Add MCP servers** (optional) -- Go to the **MCP** page in the sidebar to add and manage MCP servers. Custom skills are managed on the separate **Skills** page.\n\n---\n\n## Core Capabilities\n\n### Conversation \u0026 Coding\n\n| Capability | Details |\n|---|---|\n| Interaction modes | Code / Plan / Ask |\n| Reasoning effort | Low / Medium / High / Max + Thinking mode |\n| Permission control | Default / Full Access, per-action approval |\n| Session control | Pause, resume, rewind to checkpoint, archive |\n| Model switching | Change model mid-conversation |\n| Split screen | Side-by-side dual sessions |\n| Attachments | Files and images with multimodal vision support |\n| Slash commands | /help /clear /cost /compact /doctor /review and more |\n\n### Extensions \u0026 Integrations\n\n| Capability | Details |\n|---|---|\n| Providers | Anthropic / OpenRouter / Bedrock / Vertex / custom endpoints |\n| MCP servers | stdio / sse / http, runtime status monitoring |\n| Skills | Custom / project / global skills, skills.sh marketplace |\n| Bridge | Telegram / Feishu / Discord / QQ remote control |\n| CLI import | Import Claude Code CLI .jsonl session history |\n| Image generation | Gemini / Anthropic image gen, batch tasks, gallery |\n\n### Data \u0026 Workspace\n\n| Capability | Details |\n|---|---|\n| Assistant Workspace | Workspace root files (soul.md, user.md, claude.md, memory.md), .assistant/ state, onboarding, check-in |\n| File browser | Project file tree with syntax-highlighted preview |\n| Usage analytics | Token counts, cost estimates, daily usage charts |\n| Local storage | SQLite (WAL mode), all data stays on your machine |\n| i18n | English + Chinese |\n| Themes | Dark / Light, one-click toggle |\n\n---\n\n## Platform \u0026 Installation\n\n| Platform | Format | Architecture |\n|---|---|---|\n| macOS | .dmg | arm64 (Apple Silicon) + x64 (Intel) |\n| Windows | .exe (NSIS) | x64 + arm64 |\n| Linux | .AppImage / .deb / .rpm | x64 + arm64 |\n\nDownload from the [Releases](https://github.com/op7418/CodePilot/releases) page.\n\nmacOS builds are code-signed with a Developer ID certificate but not notarized, so Gatekeeper may still prompt on first launch. Windows and Linux builds are unsigned.\n\n\u003cdetails\u003e\n\u003csummary\u003emacOS: Gatekeeper warning on first launch\u003c/summary\u003e\n\n**Option 1** -- Right-click `CodePilot.app` in Finder \u003e Open \u003e confirm.\n\n**Option 2** -- System Settings \u003e Privacy \u0026 Security \u003e scroll to Security \u003e click Open Anyway.\n\n**Option 3** -- Run in Terminal:\n```bash\nxattr -cr /Applications/CodePilot.app\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eWindows: SmartScreen blocks the installer\u003c/summary\u003e\n\n**Option 1** -- Click \"More info\" on the SmartScreen dialog, then \"Run anyway\".\n\n**Option 2** -- Settings \u003e Apps \u003e Advanced app settings \u003e set App Install Control to allow apps from anywhere.\n\u003c/details\u003e\n\n---\n\n## Documentation\n\n📖 **Full documentation:** [English](https://www.codepilot.sh/docs) | [中文](https://www.codepilot.sh/zh/docs)\n\n**Getting started:**\n- [Quick Start](#quick-start) -- Download or build from source\n- [First Launch](#first-launch) -- Authentication, providers, workspace setup\n- [Installation Guide](https://www.codepilot.sh/docs/installation) -- Detailed setup instructions\n\n**User guides:**\n- [Providers](https://www.codepilot.sh/docs/providers) -- Configuring Anthropic, OpenRouter, Bedrock, Vertex, and custom endpoints\n- [MCP Servers](https://www.codepilot.sh/docs/mcp) -- Adding and managing Model Context Protocol servers\n- [Skills](https://www.codepilot.sh/docs/skills) -- Custom skills, project skills, and the skills.sh marketplace\n- [Bridge](https://www.codepilot.sh/docs/bridge) -- Remote control via Telegram, Feishu, Discord, QQ\n- [Assistant Workspace](https://www.codepilot.sh/docs/assistant-workspace) -- Persona files, onboarding, memory, daily check-ins\n- [FAQ](https://www.codepilot.sh/docs/faq) -- Common issues and solutions\n\n**Developer docs:**\n- [ARCHITECTURE.md](./ARCHITECTURE.md) -- Architecture, tech stack, directory structure, data flow\n- [docs/handover/](./docs/handover/) -- Design decisions and handover documents\n- [docs/exec-plans/](./docs/exec-plans/) -- Execution plans and tech debt tracker\n\n---\n\n## FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ccode\u003eclaude\u003c/code\u003e command not found\u003c/summary\u003e\n\nInstall the Claude Code CLI globally:\n```bash\nnpm install -g @anthropic-ai/claude-code\n```\nThen authenticate with `claude login`. Make sure `claude --version` works before launching CodePilot.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eConfigured a Provider but no models appear\u003c/summary\u003e\n\nVerify the API key is valid and the endpoint is reachable. Some providers (Bedrock, Vertex) require additional environment variables or IAM configuration beyond the API key. Check the provider's documentation for required setup.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eWhat is the difference between \u003ccode\u003enpm run dev\u003c/code\u003e and \u003ccode\u003enpm run electron:dev\u003c/code\u003e?\u003c/summary\u003e\n\n`npm run dev` starts only the Next.js dev server -- you use CodePilot in your browser at `http://localhost:3000`. `npm run electron:dev` starts both Next.js and the Electron shell, giving you the full desktop app experience with native window controls.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eWhere are the Assistant Workspace files?\u003c/summary\u003e\n\nWhen you set up a workspace, CodePilot creates four Markdown files at the **workspace root directory**: `soul.md` (personality), `user.md` (user profile), `claude.md` (rules), and `memory.md` (long-term notes). State tracking (onboarding progress, check-in dates) is stored in the `.assistant/` subdirectory. Daily memories go to `memory/daily/`.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eBridge requires additional setup per platform\u003c/summary\u003e\n\nEach Bridge channel (Telegram, Feishu, Discord, QQ) requires its own bot token or app credentials. Go to the **Bridge** page in the sidebar to configure channels. You will need to create a bot on the target platform first and provide the token to CodePilot.\n\u003c/details\u003e\n\n---\n\n## Community\n\n\u003cimg src=\"docs/wechat-group-qr.png\" width=\"240\" alt=\"WeChat Group QR Code\" /\u003e\n\nScan the QR code to join the WeChat user group for discussions, feedback, and updates.\n\n- [GitHub Issues](https://github.com/op7418/CodePilot/issues) -- Bug reports and feature requests\n- [GitHub Discussions](https://github.com/op7418/CodePilot/discussions) -- Questions and general discussion\n\n---\n\n## Contributing\n\n1. Fork the repository and create a feature branch\n2. `npm install` and `npm run electron:dev` to develop locally\n3. Run `npm run test` before opening a PR\n4. Submit a PR against `main` with a clear description\n\nKeep PRs focused -- one feature or fix per pull request.\n\n\u003cdetails\u003e\n\u003csummary\u003eDevelopment commands\u003c/summary\u003e\n\n```bash\nnpm run dev                    # Next.js dev server (browser)\nnpm run electron:dev           # Full Electron app (dev mode)\nnpm run build                  # Production build\nnpm run electron:build         # Build Electron distributable\nnpm run electron:pack:mac      # macOS DMG (arm64 + x64)\nnpm run electron:pack:win      # Windows NSIS installer\nnpm run electron:pack:linux    # Linux AppImage, deb, rpm\n```\n\n**CI/CD:** Pushing a `v*` tag triggers a full multi-platform build and creates a GitHub Release automatically.\n\n**Notes:**\n- Electron forks a Next.js standalone server on `127.0.0.1` with a random free port\n- Chat data is stored in `~/.codepilot/codepilot.db` (dev mode: `./data/`)\n- SQLite uses WAL mode for fast concurrent reads\n\u003c/details\u003e\n\n---\n\n## License\n\n[Business Source License 1.1 (BSL-1.1)](LICENSE)\n\n- **Personal / academic / non-profit use**: free and unrestricted\n- **Commercial use**: requires a separate license — contact 7418@openclaw.ai\n- **Change date**: 2029-03-16 — after which the code converts to Apache 2.0\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fop7418%2Fcodepilot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fop7418%2Fcodepilot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fop7418%2Fcodepilot/lists"}