The open source coding agent.

★ 227,018⑂ 30,750👁 871⑃ 29,227● 34,028▤ 897
TypeScriptMITCreated 2025-04-30opencode.ai
More from this author
Download: v1.19.5v1.19.5 ↓1.19.52026-10-28
+177
Daily
+1,390
Weekly
+14,488
Monthly
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)

News & coverage (22)

Hacker NewsAnthropic blocks third-party use of Claude Code subscriptions▲ 625 · 513 comments · 2026-01-09Hacker NewsAnthropic takes legal action against OpenCode▲ 483 · 398 comments · 2026-03-19Hacker NewsMajor security regression merged into OpenCode V2▲ 18 · 9 comments · 2026-10-13Hacker NewsOpenCode drops Claude Pro/Max subscription support per Anthropic's legal request▲ 6 · 1 comments · 2026-03-19Hacker NewsAnthropic legal request: OpenCode removes Claude subscription support▲ 6 · 1 comments · 2026-02-20Hacker NewsOpenCode is using CPU for doing nothing▲ 5 · 0 comments · 2026-05-23Hacker NewsShow HN: From Claude Code to OpenCode – My Evolution in Vibe AI Engineering▲ 2 · 0 comments · 2026-03-13NewsBytesHugging Face's Solaiman warns cyberattacks threaten open source AI access2026-11-10TechCrunch on MSNCyberattacks threaten to make open-source AI a little less open, Hugging Face exec warns2026-11-10noteSyncing multiple AI agent skills with one npx skills command — Read 18 out of 18 times by Claude Code, Codex, and OpenCode2026-11-09
12 morenoteWhere do Claude Code, Codex, and OpenCode read skills from? — A diagram of how npx skills add lets all three read the same skill at once2026-11-09noteWhat exactly is OpenCode? Things I wanted to know first as someone who wants to outsource development to AI2026-11-04Visual Studio MagazineGitHub Tracks Copilot Model Usage from OpenCode and Other Clients2026-10-26YAHOO!Critical OpenCode RCE Was Patched as a ‘Refactor.’ No CVE Exists, So Nothing Flags It.2026-10-22AndroGuiderOpenCode Hacked: Stolen API Keys Spark Massive AI Billing Fraud2026-10-19NotebookcheckOpenCode confirms breach as users report AI charges they never authorised2026-10-17Cyber Security NewsOpenCode AI Coding Agent Flaw Lets Malicious Websites Execute Code on Developer Machines2026-09-28githubGitHub Copilot now supports OpenCode2026-01-16The GitHub BlogUsage metrics API adds usage from tools like OpenCode2026-10-23KDnuggets5 Best GitHub Repositories for AI Agent Skills2026-10-21Infosecurity MagazineResearchers Warn OpenCode Quietly Patched Critical RCE Flaw, Leaving Users At Risk2026-10-20SOC PrimeKimsuky Uses OpenCode AI in GitHub PAT-Based LNK Attacks2026-09-09

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