OpenCode in IDE

paviko 1e0ab7490e Fix build: add missing @babel/preset-typescript, babel-preset-solid and @iarna/toml dependencies il y a 3 mois
.github 7773d62503 Merge public/dev and resolve conflicts in server and webgui il y a 3 mois
.husky 776091cc23 ci: add bun version check to pre-push hook to ensure version consistency il y a 4 mois
.opencode 7773d62503 Merge public/dev and resolve conflicts in server and webgui il y a 3 mois
.vscode 066a876f3d docs(contributing): Add "Setting up a Debugger" section (#4421) il y a 4 mois
github 10375263ef github: support schedule events (#5810) il y a 3 mois
hosts 77a68784d0 Updated OpenCode to v1.0.207 il y a 3 mois
infra 1a9ee3080c zen: sync il y a 3 mois
logs 1ea3a8eb9b big format il y a 5 mois
nix b745b1593f Update Nix flake.lock and hashes il y a 3 mois
packages 1e0ab7490e Fix build: add missing @babel/preset-typescript, babel-preset-solid and @iarna/toml dependencies il y a 3 mois
patches 9111005165 fix: terminal serialization and isolation il y a 4 mois
script 7773d62503 Merge public/dev and resolve conflicts in server and webgui il y a 3 mois
sdks 76880dce0d release: v1.0.207 il y a 3 mois
specs f993541e0b Refactor to support multiple instances inside single opencode process (#2360) il y a 7 mois
.editorconfig dd22cb2bb0 chore: add .editorconfig (#536) il y a 9 mois
.gitignore e641c080d3 Merge public/dev into ide-plugin and resolve conflicts il y a 3 mois
.prettierignore 28c802f399 wip: zen il y a 4 mois
AGENTS.md 85f8655dfd ignore: agents.md il y a 3 mois
CONTRIBUTING.md 0f053769db docs: add infos about server debugging (#6085) il y a 3 mois
LICENSE ef3fd5900f docs: cleanup casing il y a 9 mois
README.md 7773d62503 Merge public/dev and resolve conflicts in server and webgui il y a 3 mois
README.zh-TW.md c81506b28d docs: add Traditional Chinese (Taiwan) README translation (#5861) il y a 3 mois
STATS.md 1658a3ff59 ignore: update download stats 2025-12-29 il y a 3 mois
STYLE_GUIDE.md 7e15b4b86b Updated OpenCode to v1.0.133 il y a 4 mois
bun.lock 1e0ab7490e Fix build: add missing @babel/preset-typescript, babel-preset-solid and @iarna/toml dependencies il y a 3 mois
bunfig.toml 995b23787c ci il y a 5 mois
flake.lock b745b1593f Update Nix flake.lock and hashes il y a 3 mois
flake.nix 5e13527416 feat: nix support for the nix folks (#3924) il y a 4 mois
install 8416db03ef tweak: make install script handle 404s better il y a 3 mois
package.json 7773d62503 Merge public/dev and resolve conflicts in server and webgui il y a 3 mois
sst-env.d.ts 1a9ee3080c zen: sync il y a 3 mois
sst.config.ts a90f2b9723 ci: fix il y a 3 mois
tsconfig.json 925ce6503e sync il y a 6 mois
turbo.json 8bea479df9 ci: wtf il y a 6 mois

README.md

Unofficial OpenCode JetBrain / VSCode plugin

  • Drag and drop files to context (JetBrains: from Project Window; VS Code: from Explorer or editor tab)
  • Add all opened files to context via command/shortcut
  • Add current opened file to context via command/shortcut
  • Add selected line ranges to context via command/shortcut
  • Easier prompt editing in a dedicated text area

OpenCode IDE plugin

OpenCode logo

The open source AI coding agent.

Discord npm Build status

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 bucket add extras; scoop install extras/opencode  # Windows
choco install opencode             # Windows
brew install opencode              # macOS and Linux
paru -S opencode-bin               # Arch Linux
mise use -g github:sst/opencode # Any OS
nix run nixpkgs#opencode           # or github:sst/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-darwin-aarch64.dmg
macOS (Intel) opencode-desktop-darwin-x64.dmg
Windows opencode-desktop-windows-x64.exe
Linux .deb, .rpm, or AppImage
# macOS (Homebrew)
brew install --cask 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 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, you can switch between these using 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 a 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.

FAQ

How is this different from Claude Code?

It's very similar to Claude Code in terms of capability. Here are the key differences:

  • 100% open source
  • Not coupled to any provider. Although we recommend the models we provide through OpenCode Zen; OpenCode can be used with Claude, OpenAI, Google or even local models. As models evolve the gaps between them will close and pricing will drop so being provider-agnostic is important.
  • Out of the box LSP support
  • A focus on TUI. OpenCode is built by neovim users and the creators of terminal.shop; we are going to push the limits of what's possible in the terminal.
  • A client/server architecture. This for example can allow OpenCode to run on your computer, while you can drive it remotely from a mobile app. Meaning that the TUI frontend is just one of the possible clients.

What's the other repo?

The other confusingly named repo has no relation to this one. You can read the story behind it here.


Join our community Discord | X.com