OpenCode in IDE

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

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