The open source coding agent.

★ 227,018⑂ 30,750👁 871⑃ 29,227● 34,028▤ 897
TypeScriptMITCreated 2025-04-30opencode.ai
下载:v1.19.5v1.19.5 ↓1.19.52026-10-28
+177
日增长
+1,390
周增长
+14,488
月增长
227,018
stars
30,750
forks
871
watchers
29,227
prs
34,028
issues
897
releases

README

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

bash
 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     |

bash
 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.

---

Join our community Discord | X.com

Top issues

Latest release

v1.19.5 v1.19.5 2026-10-28
Core

 Bugfixes
- Failed TUI worker requests now return an error instead of leaving the caller hanging. (@Nowaker)

Thank you to 1 community contributor:
- @Nowaker:
  - fix(opencode): answer a failed TUI worker request instead of hanging (54936)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON