The open source coding agent. https://opencode.ai
  • TypeScript 78.7%
  • MDX 18.5%
  • CSS 2.4%
  • Astro 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-11 14:23:34 +10:00
.github chore(ci): deploy the update service from production 2026-10-10 11:29:34 -04:00
.husky refactor: restrict reflective access (#48860) 2026-09-13 17:08:43 -04:00
.opencode chore: promote v2 to dev 2026-10-10 10:58:08 -04:00
.vscode docs(contributing): Add "Setting up a Debugger" section (#4421) 2025-11-17 14:28:06 -06:00
.zed app: refactor server management backend (#13813) 2026-02-18 23:03:24 +08:00
github refactor(sdk): remove local legacy package 2026-07-26 02:47:43 -04:00
infra chore: promote v2 to dev 2026-10-10 10:58:08 -04:00
nix chore: update nix node_modules hashes 2026-10-10 08:02:42 +00:00
packages fix(app): follow the first palette result until explicit selection (#54275) 2026-10-11 14:23:34 +10:00
patches fix(provider): accept OpenAI ultrafast service tier (#53875) 2026-10-08 00:52:08 -05:00
perf Skip git setup for processor tool test (#28406) 2026-05-19 18:09:15 -04:00
script chore: promote v2 to dev 2026-10-10 10:58:08 -04:00
sdks/vscode sync release versions for v2.0.26 [skip ci] 2026-10-08 19:45:51 +00:00
services feat(core): archive projects whose directories are gone (#54354) 2026-10-10 21:11:05 -04:00
specs/v2 feat(core): enforce skill integration policies 2026-10-07 15:39:27 -05:00
.dockerignore feat: initial datalake and stats site (#28666) 2026-05-25 17:34:04 -05:00
.editorconfig
.gitattributes test(ci): register omitted V2 unit suites (#45970) 2026-08-28 21:58:54 +00:00
.gitignore chore: remove unused artifacts directory (#53436) 2026-10-06 03:14:02 +05:30
.gitleaksignore Add native LLM core foundation (#24712) 2026-05-08 16:56:20 -04:00
.oxlintrc.json feat(gui-extensions): add typed composition and lifetime primitives (#52868) 2026-10-04 13:16:37 +10:00
.prettierignore fix(client): exclude generated files from formatting (#33832) 2026-06-25 07:53:00 -04:00
AGENTS.md chore: promote v2 to dev 2026-10-10 10:58:08 -04:00
bun.lock chore: promote v2 to dev 2026-10-10 10:58:08 -04:00
bunfig.toml feat(cli): pair remotely through OpenTunnel (#53837) 2026-10-07 22:29:50 -04:00
CHANGELOG.md sync release versions for v2.0.26 [skip ci] 2026-10-08 19:45:51 +00:00
CONTRIBUTING.md chore: promote v2 to dev 2026-10-10 10:58:08 -04:00
flake.lock chore(nix): update nixpkgs for Bun 1.4 (#50221) 2026-09-27 21:34:52 -05:00
flake.nix fix(nix): drop x86_64-darwin target and unblock flake eval on nixpkgs 26.11 (#52129) 2026-10-01 01:55:00 -05:00
install fix(install): use latest release channel (#49261) 2026-09-15 21:30:38 -05:00
LICENSE
package.json chore: upgrade Effect to 4.0.1 (#54198) 2026-10-10 00:55:24 -07:00
README.ar.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.bn.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.br.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.bs.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.da.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.de.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.es.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.fr.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.gr.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.it.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.ja.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.ko.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.no.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.pl.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.ru.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.th.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.tr.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.uk.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.vi.md ignore: cleanup readme (#28049) 2026-05-17 11:26:23 -05:00
README.zh.md chore: merge dev into v2 (#35591) 2026-07-06 16:05:29 -05:00
README.zht.md chore: merge dev into v2 (#35591) 2026-07-06 16:05:29 -05:00
screenshot-uk.png feat(i18n): add Ukrainian (uk) locale support (#28061) 2026-05-19 14:45:39 +08:00
SECURITY.md docs: add policy about AI-generated security reports 2026-02-18 09:15:18 -05:00
sst-env.d.ts zen: track model tier in stats 2026-06-24 14:34:58 -04:00
sst.config.ts chore: promote v2 to dev 2026-10-10 10:58:08 -04:00
STATS.md ignore: update download stats 2026-01-29 2026-01-29 12:07:50 +00:00
tsconfig.json sync 2025-09-27 04:10:56 -04:00
turbo.json fix(cli): reuse core declarations during typecheck (#51165) 2026-09-24 13:16:46 -04:00
V2_HTTP_API_AUDIT.md feat(server): expose server info endpoint 2026-09-16 21:43:58 -04:00

OpenCode logo

The open source AI coding agent.

Discord npm Build status

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt

OpenCode Terminal UI


Installation

# 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 branch

Tip

Remove versions older than 0.1.x before installing.

Desktop App (BETA)

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

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

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