OpenCode in IDE

paviko 2e412ff015 feat(webgui): add token usage stats display to assistant messages 1 ماه پیش
.github dc7d17f3a9 Merge public/dev and resolve conflicts (.gitignore, bun.lock, vite.config.ts) 1 ماه پیش
.husky 776091cc23 ci: add bun version check to pre-push hook to ensure version consistency 2 ماه پیش
.opencode 32b94f7a8d feat(webgui): add OAuth instructions support 1 ماه پیش
.vscode 066a876f3d docs(contributing): Add "Setting up a Debugger" section (#4421) 2 ماه پیش
github 10375263ef github: support schedule events (#5810) 1 ماه پیش
hosts 2e412ff015 feat(webgui): add token usage stats display to assistant messages 1 ماه پیش
infra 1a9ee3080c zen: sync 1 ماه پیش
logs 1ea3a8eb9b big format 3 ماه پیش
nix d59357c89b Update Nix flake.lock and hashes 1 ماه پیش
packages 2e412ff015 feat(webgui): add token usage stats display to assistant messages 1 ماه پیش
patches 9111005165 fix: terminal serialization and isolation 2 ماه پیش
script dc7d17f3a9 Merge public/dev and resolve conflicts (.gitignore, bun.lock, vite.config.ts) 1 ماه پیش
scripts cb0e05db26 docs: add auto-reload and monthly limits documentation to Zen guide 1 ماه پیش
sdks 01237c5325 release: v1.0.223 1 ماه پیش
specs f993541e0b Refactor to support multiple instances inside single opencode process (#2360) 5 ماه پیش
.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 81fef60266 fix: ensure variants also work for completely custom models (#6481) 1 ماه پیش
CONTRIBUTING.md e5c5b5e872 docs: add run from source guide (#6405) 1 ماه پیش
LICENSE ef3fd5900f docs: cleanup casing 7 ماه پیش
README.md dc7d17f3a9 Merge public/dev and resolve conflicts (.gitignore, bun.lock, vite.config.ts) 1 ماه پیش
README.zh-TW.md c81506b28d docs: add Traditional Chinese (Taiwan) README translation (#5861) 1 ماه پیش
STATS.md 41f9a58c27 ignore: update download stats 2026-01-01 1 ماه پیش
STYLE_GUIDE.md 7e15b4b86b Updated OpenCode to v1.0.133 2 ماه پیش
bun.lock dc7d17f3a9 Merge public/dev and resolve conflicts (.gitignore, bun.lock, vite.config.ts) 1 ماه پیش
bunfig.toml 995b23787c ci 3 ماه پیش
flake.lock d59357c89b Update Nix flake.lock and hashes 1 ماه پیش
flake.nix 8fa1af851c style(nix): use idiomatic inherit syntax (#6457) 1 ماه پیش
install 8416db03ef tweak: make install script handle 404s better 1 ماه پیش
package.json 7773d62503 Merge public/dev and resolve conflicts in server and webgui 1 ماه پیش
sst-env.d.ts 1a9ee3080c zen: sync 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 opencode              # macOS and Linux
paru -S opencode-bin               # Arch Linux
mise use -g 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