CodePilot

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

---

Download

Or visit the Releases page for all versions.

---

Why CodePilot

Multi-provider, one interface

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

Beyond coding — a full AI agent

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.

Built for daily use

• 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

---

Quick Start

Path A: Download a release (most users)

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.

Path B: Build from source (developers)

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

---

Core Capabilities

Conversation & Interaction

Extensions & Integrations

Data & Workspace

---

First Launch

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

---

Platform & Installation Notes

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.

---

Documentation

📖 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

---

FAQ

---

Community

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

---

Contributing

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.

---

License

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