anomalyco / opencode

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
 [code] 
> [!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` |
 [code] 
#### Installation Directory
The install script respects the following priority order for the installation path:
1. `$OPENCODE_INSTALL_DIR` - Custom installation directory
2. `$XDG_BIN_DIR` - XDG Base Directory Specification compliant path
3. `$HOME/bin` - Standard user binary directory (if it exists or can be created)
4. `$HOME/.opencode/bin` - Default fallback
 [code] 
### 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.
---
**Join our community** Discord | X.com