OpenCode in IDE

paviko c8d1a76453 feat: add session retry functionality with error handling and UI integration 1 ماه پیش
.github be32d4cf76 Merge public/dev into current branch — resolve conflicts: server: mount /app, add fetch RPC, update deps (@modelcontextprotocol/[email protected], keep @iarna/toml) 1 ماه پیش
.husky 776091cc23 ci: add bun version check to pre-push hook to ensure version consistency 2 ماه پیش
.opencode a721810682 ci: tweak prompt 1 ماه پیش
.vscode 066a876f3d docs(contributing): Add "Setting up a Debugger" section (#4421) 2 ماه پیش
github 0917991361 docs: update GHA examples to use `actions/checkout@v6` (#6969) 1 ماه پیش
hosts eb6d20f2f5 Updated OpenCode to v1.1.2 1 ماه پیش
infra 80772e5ac2 ci 1 ماه پیش
logs 1ea3a8eb9b big format 3 ماه پیش
nix 7cba1ff793 Update Nix flake.lock and hashes 1 ماه پیش
packages c8d1a76453 feat: add session retry functionality with error handling and UI integration 1 ماه پیش
patches 9111005165 fix: terminal serialization and isolation 2 ماه پیش
script be32d4cf76 Merge public/dev into current branch — resolve conflicts: server: mount /app, add fetch RPC, update deps (@modelcontextprotocol/[email protected], keep @iarna/toml) 1 ماه پیش
sdks 8a43c24934 release: v1.1.11 1 ماه پیش
specs 559013e124 docs: perf plans 1 ماه پیش
.editorconfig dd22cb2bb0 chore: add .editorconfig (#536) 7 ماه پیش
.gitignore dc7d17f3a9 Merge public/dev and resolve conflicts (.gitignore, bun.lock, vite.config.ts) 1 ماه پیش
.prettierignore 28c802f399 wip: zen 2 ماه پیش
AGENTS.md 4f1ef93910 ignore 1 ماه پیش
CONTRIBUTING.md c74bc323b6 ci: tweak enforcement of titles 1 ماه پیش
LICENSE ef3fd5900f docs: cleanup casing 7 ماه پیش
README.md be32d4cf76 Merge public/dev into current branch — resolve conflicts: server: mount /app, add fetch RPC, update deps (@modelcontextprotocol/[email protected], keep @iarna/toml) 1 ماه پیش
README.zh-CN.md 662d2b205a docs: update brew formula stuff to recommend our tap 1 ماه پیش
README.zh-TW.md 662d2b205a docs: update brew formula stuff to recommend our tap 1 ماه پیش
STATS.md e92a2ec9db ignore: update download stats 2026-01-10 1 ماه پیش
STYLE_GUIDE.md e37fd9c105 core: add interactive question tool for gathering user preferences and clarifying instructions (#7268) 1 ماه پیش
bun.lock be32d4cf76 Merge public/dev into current branch — resolve conflicts: server: mount /app, add fetch RPC, update deps (@modelcontextprotocol/[email protected], keep @iarna/toml) 1 ماه پیش
bunfig.toml 351ddeed91 Permission rework (#6319) 1 ماه پیش
flake.lock 7cba1ff793 Update Nix flake.lock and hashes 1 ماه پیش
flake.nix e00621cb17 feat(nix): preliminary desktop app flake integration (#6135) 1 ماه پیش
install 45fea6587e fix: use actual version in install script (#7044) 1 ماه پیش
package.json 74faae7864 Merge public/dev: Update permission system for webgui 1 ماه پیش
sst-env.d.ts 23fc675ad5 wip: black 1 ماه پیش
sst.config.ts a90f2b9723 ci: fix 1 ماه پیش
tsconfig.json 925ce6503e sync 4 ماه پیش
turbo.json 8bea479df9 ci: wtf 4 ماه پیش

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 anomalyco/tap/opencode # macOS and Linux (recommended, always up to date)
brew install opencode              # macOS and Linux (official brew formula, updated less)
paru -S opencode-bin               # Arch Linux
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-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 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 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.

Join our community Discord | X.com