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.

中文文档 | 日本語

Skills and extensions	Connect AI services

Download | Quick Start | Documentation | Contributing | Community

Download

Official macOS stable builds can check, download, and install signed updates in the app. After manually installing the first supported Windows version, later Windows releases can update in the app using unsigned packages from the official GitHub Release; Linux releases remain manual downloads.

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 stable builds are signed with Developer ID, notarized, stapled, and verified by Gatekeeper. If macOS reports that the developer cannot be verified or the file is damaged, stop and report it instead of bypassing the warning. Windows builds are unsigned and may show SmartScreen. After manually installing the first Windows updater-capable release, later stable versions can update in-app from the official op7418/CodePilot GitHub Release; the app verifies the metadata SHA-512 but does not claim independent Authenticode publisher verification. Linux updates remain manual.

1. Delete the rejected copy and download it again from the official GitHub Release.
2. Verify the file against SHA256SUMS.txt from the same Release.
3. If Gatekeeper still rejects it, do not remove quarantine attributes or bypass the warning; report the macOS version, download URL, and checksum on GitHub Issues.

Verify the installer against SHA256SUMS.txt from the same official Release first. If the checksum matches and the source is op7418/CodePilot, click "More info", then "Run anyway". If organization policy removes that option, contact the device administrator instead of weakening system-wide protection.

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](https://www.codepilot.sh/docs/assis