Luke Parker
be315b1db8
Brings the desktop beta work into dev as a merge commit, so its history is kept. Core, server and client changes from beta were backported to dev one PR at a time first (#59081 to #59107). Left out of this merge, so dev keeps its current behaviour: - Generated UI, entirely: the plugin-genui package, its core registration and publishing, the session-ui surfaces, charts, form replies and streaming tool input, the app setting and its strings, tool-input delta publishing, and their tests. It lands on dev later through its own pull request. - The `ast-grep-ignore: no-star-import` comment in cross-spawn-spawner.ts, which lint:effect-patterns still needs. Notes: - Dev-channel builds now use their own service-dev.json, port and opencode-dev.db (#58331), so dev-build users start on a fresh database. - #56550 (plugin instruction entries) and #57527 (untracked folder rows) come in as on beta; follow-ups go to dev. - Docs from beta are pointed at check-test.yml, after the workflow rename. - #59132's fix (settings toggles MCP servers in the session's location) is ported onto beta's rewritten Extensions page, and #59131's browser title test joins beta's tab tests.
The open source AI coding agent.
English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt
Installation
# YOLO
curl -fsSL https://opencode.ai/v2/install | bash
# Package managers
npm i -g @opencode/cli@latest # or bun/pnpm/yarn
brew install anomalyco/tap/opencode-v2 # 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-beta # Arch Linux (Latest from AUR)
mise use -g opencode # Any OS
nix run github:anomalyco/opencode # Nix
Tip
Remove versions older than 0.1.x before installing.
Desktop App (BETA)
OpenCode is also available as a desktop application. Download it from opencode.ai/download.
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | opencode-desktop-mac-arm64.dmg |
| macOS (Intel) | opencode-desktop-mac-x64.dmg |
| Windows | opencode-desktop-win-x64.exe |
| Linux | .deb, .rpm, or .AppImage |
# macOS (Homebrew)
brew install --cask opencode-desktop
Installation Directory
The install script installs OpenCode to $HOME/.opencode/bin.
Agents
OpenCode 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.
Documentation
For more info on how to configure OpenCode, head over to our docs.
Contributing
If you're interested in contributing to OpenCode, please read our contributing docs before submitting a pull request.
Building on OpenCode
If you are working on a project that's related to OpenCode and is using "opencode" as part of its name, for example "opencode-dashboard" or "opencode-mobile", please add a note to your README to clarify that it is not built by the OpenCode team and is not affiliated with us in any way.