A multi-model AI agent desktop client -- connect any AI provider, extend with MCP & skills, control from your phone, and let your assistant learn your workflow.

中文文档 | 日本語

Download | Quick Start | Documentation | Contributing | Community

Or visit the Releases page for all versions.

Connect to 17+ AI providers out of the box. Switch providers and models mid-conversation without losing context.

CodePilot started as a coding tool but has grown into a general-purpose AI agent desktop:

• Assistant Workspace — Persona files, persistent memory, onboarding flows, and daily check-ins. Your assistant learns your preferences and adapts over time.
• Generative UI — AI can create interactive dashboards, charts, and visual widgets rendered live in-app.
• Remote Bridge — Connect to Telegram, Feishu, Discord, QQ, and WeChat. Send messages from your phone, get responses on your desktop.
• MCP + Skills — Add MCP servers (stdio / sse / http) with runtime monitoring. Define reusable skills or install from the skills.sh marketplace.
• Media Studio — AI image generation with batch tasks, gallery, and tagging.
• Task Scheduler — Schedule recurring tasks with cron expressions or intervals.

• Pause, resume, and rewind sessions to any checkpoint
• Split-screen dual sessions side by side
• Track token usage and costs with daily charts
• Import Claude Code CLI session history
• Dark / Light theme toggle
• English + Chinese interface

1. Download the installer for your platform from the Download section above
2. Launch CodePilot
3. Configure a Provider in Settings > Providers — add your API key for any supported provider
4. Start a conversation

Note: Installing the Claude Code CLI (npm install -g @anthropic-ai/claude-code) unlocks additional capabilities like direct file editing, terminal commands, and git operations. It is recommended but not required for basic chat.

git clone https://github.com/op7418/CodePilot.git
cd CodePilot
npm install
npm run dev              # browser mode at http://localhost:3000
# -- or --
npm run electron:dev     # full desktop app

1. Configure a Provider — Go to Settings > Providers and add credentials for the provider you want to use. CodePilot includes presets for all major providers — just pick one and enter your API key.
2. Create a conversation — Pick a working directory, select a mode (Code / Plan / Ask), and choose a model.
3. Set up Assistant Workspace (optional) — Go to Settings > Assistant, choose a workspace directory, and enable Onboarding. CodePilot creates soul.md, user.md, claude.md, and memory.md at the workspace root.
4. 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.
5. Install Claude Code CLI (optional) — For advanced features like file editing and terminal commands, install the CLI: npm install -g @anthropic-ai/claude-code

macOS 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.

xattr -cr /Applications/CodePilot.app

📖 Full documentation: English | 中文

Getting started:

• Quick Start -- Download or build from source
• First Launch -- Provider setup, workspace configuration
• Installation Guide -- Detailed setup instructions

User guides:

• Providers -- Configuring AI providers and custom endpoints
• MCP Servers -- Adding and managing Model Context Protocol servers
• Skills -- Custom skills, project skills, and the skills.sh marketplace
• Bridge -- Remote control via Telegram, Feishu, Discord, QQ, WeChat
• Assistant Workspace -- Persona files, onboarding, memory, daily check-ins
• FAQ -- Common issues and solutions

Developer docs:

• ARCHITECTURE.md -- Architecture, tech stack, directory structure, data flow
• docs/handover/ -- Design decisions and handover documents
• docs/exec-plans/ -- Execution plans and tech debt tracker

Scan the QR code to join the WeChat user group for discussions, feedback, and updates.

• GitHub Issues -- Bug reports and feature requests
• GitHub Discussions -- Questions and general discussion

1. Fork the repository and create a feature branch
2. npm install and npm run electron:dev to develop locally
3. Run npm run test before opening a PR
4. Submit a PR against main with a clear description

Keep PRs focused -- one feature or fix per pull request.

npm run dev                    # Next.js dev server (browser)
npm run electron:dev           # Full Electron app (dev mode)
npm run build                  # Production build
npm run electron:build         # Build Electron distributable
npm run electron:pack:mac      # macOS DMG (arm64 + x64)
npm run electron:pack:win      # Windows NSIS installer
npm run electron:pack:linux    # Linux AppImage, deb, rpm

Business Source License 1.1 (BSL-1.1)

• Personal / academic / non-profit use: free and unrestricted
• Commercial use: requires a separate license — contact @op7418 on X
• Change date: 2029-03-16 — after which the code converts to Apache 2.0