OpenCode in IDE

Aiden Cline a1fdeded3e tweak: allow mcp servers to include headers (#1096) 7 月之前
.github fdd6d6600f docs: rename workflow 7 月之前
infra 1c4fd7f28f Api: add endpoint for getting github app token 7 月之前
packages a1fdeded3e tweak: allow mcp servers to include headers (#1096) 7 月之前
scripts c3c647a21a wip: github actions 7 月之前
sdks a86d42149f wip: github actions 7 月之前
.editorconfig dd22cb2bb0 chore: add .editorconfig (#536) 7 月之前
.gitignore 5a0910ea79 chore: better local dev with stainless script 7 月之前
AGENTS.md 1cf1d1f634 docs: fix agents.md 7 月之前
LICENSE ef3fd5900f docs: cleanup casing 8 月之前
README.md 7f659cce36 docs: Update README.md 7 月之前
STATS.md 2051312d12 ignore: update download stats 2025-07-17 7 月之前
bun.lock d4f9375548 fix: type 'reasoning' was provided without its required following item (#1072) 7 月之前
bunfig.toml 1472efcbfe Optimize package management with catalog and exact versions 8 月之前
install d6eff3b3a3 improve error handling and logging for GitHub API failures in upgrade and install script (#972) 7 月之前
opencode.json a2002c88c6 wip: update sdk 7 月之前
package.json d4f9375548 fix: type 'reasoning' was provided without its required following item (#1072) 7 月之前
sst-env.d.ts 1c4fd7f28f Api: add endpoint for getting github app token 7 月之前
sst.config.ts f3da73553c sync 8 月之前
stainless-workspace.json 5a0910ea79 chore: better local dev with stainless script 7 月之前
stainless.yml cdc1d8a94d feat(tui): layout config to render full width 7 月之前
tsconfig.json 780419ecae ci: daily stats script 7 月之前

README.md

opencode logo

AI coding agent, built for the terminal.

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
brew install sst/tap/opencode      # macOS
paru -S opencode-bin               # Arch Linux

[!TIP] Remove versions older than 0.1.x before installing.

Documentation

For more info on how to configure opencode head over to our docs.

Contributing

opencode is an opinionated tool so any fundamental feature needs to go through a design process with the core team.

[!IMPORTANT] We do not accept PRs for core features.

However we still merge a ton of PRs - you can contribute:

  • Bug fixes
  • Improvements to LLM performance
  • Support for new providers
  • Fixes for env specific quirks
  • Missing standard behavior
  • Documentation

Take a look at the git history to see what kind of PRs we end up merging.

[!NOTE] If you do not follow the above guidelines we might close your PR.

To run opencode locally you need.

  • Bun
  • Golang 1.24.x

And run.

$ bun install
$ bun run packages/opencode/src/index.ts

Development Notes

API Client: After making changes to the TypeScript API endpoints in packages/opencode/src/server/server.ts, you will need the opencode team to generate a new stainless sdk for the clients.

FAQ

How is this different than 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 Anthropic is recommended, opencode can be used with 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.
  • 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 | YouTube | X.com