OpenCode in IDE

paviko b1dcbe49fb #1 Files changes panel fix 2 miesięcy temu
.github d7c0e9fe4f Merge public/dev into current branch — resolve conflicts in bun.lock and server: mount /app 2 miesięcy temu
.husky 776091cc23 ci: add bun version check to pre-push hook to ensure version consistency 4 miesięcy temu
.opencode d83756eaaf chore: generate 2 miesięcy temu
.vscode 066a876f3d docs(contributing): Add "Setting up a Debugger" section (#4421) 4 miesięcy temu
github a092f567b7 fix(github): add persist-credentials: false to workflow templates (#8202) 2 miesięcy temu
hosts 7be9bedd1d Cache buster 2 miesięcy temu
infra 12ae80856e wip: zen 2 miesięcy temu
logs 1ea3a8eb9b big format 5 miesięcy temu
nix 438916de5f Update node_modules hash (x86_64-darwin) 2 miesięcy temu
packages b1dcbe49fb #1 Files changes panel fix 2 miesięcy temu
patches 9111005165 fix: terminal serialization and isolation 4 miesięcy temu
script d7c0e9fe4f Merge public/dev into current branch — resolve conflicts in bun.lock and server: mount /app 2 miesięcy temu
sdks bc3616d9c6 release: v1.1.24 2 miesięcy temu
specs 559013e124 docs: perf plans 3 miesięcy temu
themes 92089bb295 chore: generate 2 miesięcy temu
.editorconfig dd22cb2bb0 chore: add .editorconfig (#536) 9 miesięcy temu
.gitignore d7c0e9fe4f Merge public/dev into current branch — resolve conflicts in bun.lock and server: mount /app 2 miesięcy temu
.prettierignore 28c802f399 wip: zen 4 miesięcy temu
AGENTS.md c86c2acf4c add fullscreen view to permission prompt 2 miesięcy temu
CONTRIBUTING.md c74bc323b6 ci: tweak enforcement of titles 3 miesięcy temu
LICENSE ef3fd5900f docs: cleanup casing 9 miesięcy temu
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) 3 miesięcy temu
README.zh-CN.md 662d2b205a docs: update brew formula stuff to recommend our tap 3 miesięcy temu
README.zh-TW.md 662d2b205a docs: update brew formula stuff to recommend our tap 3 miesięcy temu
SECURITY.md 6b6d6e9e07 update security 2 miesięcy temu
STATS.md f197b8a0cd ignore: update download stats 2026-01-16 2 miesięcy temu
STYLE_GUIDE.md c86c2acf4c add fullscreen view to permission prompt 2 miesięcy temu
bun.lock d7c0e9fe4f Merge public/dev into current branch — resolve conflicts in bun.lock and server: mount /app 2 miesięcy temu
bunfig.toml 351ddeed91 Permission rework (#6319) 3 miesięcy temu
flake.lock 60aa0cb96e Update Nix flake.lock and x86_64-linux hash 2 miesięcy temu
flake.nix ca1b597b01 fix(nix): filter optional dependencies by target platform (#8033) 2 miesięcy temu
install 4d08123ca0 feat(install): respect ZDOTDIR for zsh config detection (#8511) 2 miesięcy temu
package.json d7c0e9fe4f Merge public/dev into current branch — resolve conflicts in bun.lock and server: mount /app 2 miesięcy temu
sst-env.d.ts f66e6d7033 wip: zen 2 miesięcy temu
sst.config.ts a90f2b9723 ci: fix 3 miesięcy temu
tsconfig.json 925ce6503e sync 6 miesięcy temu
turbo.json 8bea479df9 ci: wtf 6 miesięcy temu

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