The open source AI coding agent.
# YOLO
curl -fsSL https://raw.githubusercontent.com/PetrouilFan/devpilot/dev/install.sh | bash
# Package managers
npm i -g @devpilot-ai/cli@latest # or bun/pnpm/yarn
# brew install petrouilfan/tap/devpilot # macOS and Linux (recommended, always up to date)
# brew install devpilot # macOS and Linux (official brew formula, updated less)
# sudo pacman -S devpilot # Arch Linux (Stable)
# paru -S devpilot-bin # Arch Linux (Latest from AUR)
# mise use -g devpilot # Any OS
# nix run nixpkgs#devpilot # or github:PetrouilFan/devpilot for latest dev branchTip
Remove versions older than 0.1.x before installing.
DevPilot is also available as a desktop application. Download directly from the releases page.
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | devpilot-desktop-mac-arm64.dmg |
| macOS (Intel) | devpilot-desktop-mac-x64.dmg |
| Windows | devpilot-desktop-windows-x64.exe |
| Linux | .deb, .rpm, or .AppImage |
# macOS (Homebrew)
# brew install --cask devpilot-desktop
# Windows (Scoop)
# scoop bucket add extras; scoop install extras/devpilot-desktopThe install script respects the following priority order for the installation path:
$DEVPILOT_INSTALL_DIR- Custom installation directory$XDG_BIN_DIR- XDG Base Directory Specification compliant path$HOME/bin- Standard user binary directory (if it exists or can be created)$HOME/.devpilot/bin- Default fallback
# Examples
DEVPILOT_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/PetrouilFan/devpilot/dev/install.sh | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://raw.githubusercontent.com/PetrouilFan/devpilot/dev/install.sh | bashDevPilot includes several built-in agents you can switch between with the Tab key.
- build - Default, full-access agent for development work
- plan - Read-only agent for analysis and code exploration
- Denies file edits by default
- Asks permission before running bash commands
- Ideal for exploring unfamiliar codebases or planning changes
Also included are subagents used internally and via the task tool:
- general - General-purpose agent for complex searches and multi-step tasks
- explore - Read-only codebase search specialist
- orchestrator - Decomposes complex tasks into parallel subtasks and synthesizes results
Learn more about agents.
DevPilot supports parallel subagent execution via the batch task tool. Tasks can declare dependencies (depends_on) for DAG-based scheduling, specify output contracts, and configure failure handling (fail-fast, continue, retry). Filesystem isolation (worktree or scope mode) prevents subagents from accessing files outside their working directory.
See docs/agents.md for the full subagent and orchestrator reference.
Subagent behavior is configured in devpilot.json under the subagents key:
See the configuration docs for all available fields.
For more info on how to configure DevPilot, head over to our docs.
If you're interested in contributing to DevPilot, please read our contributing docs before submitting a pull request.
If you are working on a project that's related to DevPilot and is using "devpilot" as part of its name, for example "devpilot-dashboard" or "devpilot-mobile", please add a note to your README to clarify that it is not built by the DevPilot team and is not affiliated with us in any way.
Join our community GitHub Discussions | GitHub Issues
{ "subagents": { "model": "anthropic/claude-haiku-3.5", "max_concurrency": 5, "isolation": "worktree", "orchestrator": "orchestrator", "orchestrator_trigger": "auto" } }