op7418/CodePilot is a AI Tools project on GitHub, written primarily in TypeScript. It has 6.5k stars. A multi-model AI agent desktop client — connect any AI provider, extend with MCP & skills, control from your phone. Built with Electron + Next.js.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
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.
中文文档 | 日本語
More of the current interface
Skills and extensions
Connect AI services
Download | Quick Start | Documentation | Contributing | Community
Download
Platform
Download
Architecture
macOS
Apple Silicon (.dmg) · Intel (.dmg)
arm64 / x64
Windows
Installer (.exe)
x64
Linux
AppImage / deb / rpm
x64 / arm64
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.
Any Anthropic-compatible or OpenAI-compatible endpoint
Media
Google Gemini (image generation)
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)
Download the installer for your platform from the Download section above
Launch CodePilot
Configure a Provider in Settings > Providers — add your API key for any supported provider
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)
Prerequisite
Minimum version
Node.js
18+
npm
9+ (ships with Node 18)
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
Capability
Details
Interaction modes
Code / Plan / Ask
Reasoning effort
Low / Medium / High / Max + Thinking mode
Permission control
Default / Full Access, per-action approval
Session control
Pause, resume, rewind to checkpoint, archive
Model switching
Change model mid-conversation
Split screen
Side-by-side dual sessions
Attachments
Files and images with multimodal vision support
Slash commands
/help /clear /cost /compact /doctor /review and more
AI-created interactive dashboards and visual widgets
File browser
Project file tree with syntax-highlighted preview
Git panel
Status, branches, commits, worktree management
Usage analytics
Token counts, cost estimates, daily usage charts
Task scheduler
Cron-based and interval scheduling with persistence
Local storage
SQLite (WAL mode), all data stays on your machine
i18n
English + Chinese
Themes
Dark / Light, one-click toggle
First Launch
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.
Create a conversation — Pick a working directory, select a mode (Code / Plan / Ask), and choose a model.
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.
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.
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.
macOS: Gatekeeper rejects the download
Delete the rejected copy and download it again from the official GitHub Release.
Verify the file against SHA256SUMS.txt from the same Release.
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.
Windows: SmartScreen blocks the installer
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 -- 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
Do I need the Claude Code CLI?
No. You can use CodePilot with any supported provider (OpenRouter, Zhipu GLM, Volcengine, Ollama, etc.) without the Claude Code CLI. The CLI is only needed if you want Claude to directly edit files, run terminal commands, or use git operations on your machine. For chat and assistant features, just configure a provider and start a conversation.
Configured a Provider but no models appear
Verify 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. Use the built-in diagnostics (Settings > Providers > Run Diagnostics) to check connectivity.
What is the difference between npm run dev and npm run electron:dev?
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.
Where are the Assistant Workspace files?
When 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/.
Bridge requires additional setup per platform
Each Bridge channel (Telegram, Feishu, Discord, QQ, WeChat) 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.
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
Fork the repository and create a feature branch
npm install and npm run electron:dev to develop locally
Run npm run test before opening a PR
Submit a PR against main with a clear description
Keep PRs focused -- one feature or fix per pull request.
Development commands
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
CI/CD: Pushing a stable vX.Y.Z tag builds signed/notarized macOS arm64, x64, and universal packages plus latest-mac.yml; an unsigned Windows x64 NSIS updater plus latest.yml; and Linux arm64/x64 manual packages. The Release is made public only after signing/notarization where applicable, packaged health, checksum, attestation, Intel ABI, GitHub single-trust-root safeguards, and complete asset-graph checks pass. The unsigned Windows trust gate requires a fresh administrator audit of immutable Releases and no-bypass branch/tag rulesets; Actions compares the live ruleset IDs and update timestamps with that audit and fails closed on drift. Windows publishes an EXE blockmap for opportunistic differential updates with full-installer fallback; Linux updater metadata is intentionally not published.
Notes:
Electron forks a Next.js standalone server on 127.0.0.1 with a random free port
Chat data is stored in ~/.codepilot/codepilot.db (dev mode: ./data/)
SQLite uses WAL mode for fast concurrent reads
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
The most recent commit recorded on op7418/CodePilot was 3 months ago, based on the GitHub push timestamp. The repository has 695 forks — one of the better signals of community interest.
How many stars does op7418/CodePilot have?
op7418/CodePilot has 6.5k GitHub stars — refresh the page for the live number, or check github.com/op7418/CodePilot. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is op7418/CodePilot open source?
TopGit's metadata for op7418/CodePilot does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What else is in the AI Tools space?
op7418/CodePilot is tracked by TopGit under the AI Tools category, alongside 8 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is op7418/CodePilot?
op7418/CodePilot (op7418/CodePilot) is a TypeScript project on GitHub. From the project's own README: A multi-model AI agent desktop client — connect any AI provider, extend with MCP & skills, control from your phone. Built with Electron + Next.js.
What language is op7418/CodePilot written in?
op7418/CodePilot is written primarily in TypeScript. GitHub's language field is based on the largest share of bytes in the default branch.
Where do I read more about op7418/CodePilot?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/op7418/CodePilot is the definitive source.
Read full README in the tab above.
Is CodePilot worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of CodePilot.