The open source AI coding agent.
A quality-of-life fork of OpenCode with additional features and improvements.
English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt
This is a community fork of OpenCode maintained by Bailey Maynard. It is not affiliated with or endorsed by the OpenCode team. All upstream features and documentation apply — see opencode.ai/docs for general usage.
If you are building a project that uses "opencode" as part of its name, please clarify in your README that it is not built by the OpenCode team.
This fork adds several quality-of-life improvements on top of standard OpenCode.
Git Panel — A full VCS sidebar with branch selector (checkout and create-branch dialog), staged/unstaged file lists, stage-all/unstage-all, commit, and push. Stage-all auto-generates a commit message from your staged diff, and long-running pushes show a spinner.
In-App File Editor — A CodeMirror editor embedded in file tabs. Open any file with edit:// protocol, edit with syntax highlighting, save with Ctrl+S or the save button, and revert unsaved changes.
Programming Mode — A settings toggle that opens the Git panel by default in the sidebar and shows a "Code" tab for quick file access.
Home Session Delete — Delete sessions directly from the home page with a trash button.
Mobile Changes & Git Tabs — The changes panel gains an "All" mode showing the full file tree with add/delete markers, plus a Git tab for viewing branches, committing, and pushing from mobile.
# YOLO
curl -fsSL https://opencode.ai/install | bash
# Package managers
npm i -g opencode-ai@latest # or bun/pnpm/yarn
scoop install opencode # Windows
choco install opencode # Windows
brew install anomalyco/tap/opencode # macOS and Linux (recommended, always up to date)
brew install opencode # macOS and Linux (official brew formula, updated less)
sudo pacman -S opencode # Arch Linux (Stable)
paru -S opencode-bin # Arch Linux (Latest from AUR)
mise use -g opencode # Any OS
nix run nixpkgs#opencode # or github:anomalyco/opencode for latest dev branchTip
Remove versions older than 0.1.x before installing.
OpenCode is also available as a desktop application. Download directly from the releases page or opencode.ai/download.
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | opencode-desktop-mac-arm64.dmg |
| macOS (Intel) | opencode-desktop-mac-x64.dmg |
| Windows | opencode-desktop-windows-x64.exe |
| Linux | .deb, .rpm, or .AppImage |
# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktopThe install script respects the following priority order for the installation path:
$OPENCODE_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/.opencode/bin- Default fallback
# Examples
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bashOpenCode includes two 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 is a general subagent for complex searches and multistep tasks.
This is used internally and can be invoked using @general in messages.
Learn more about agents.
For more info on how to configure OpenCode, head over to our docs.
Contributions to upstream OpenCode go to anomalyco/opencode. Please read their contributing docs before submitting a pull request.