What is opencode?
opencode is the open source AI coding agent for your terminal. You install it as a command-line tool and use it to explore, write, and change code in your projects. It sits in the Autonomous Coding Agents category of the AI Coding tools and is open-source, written in TypeScript and licensed MIT.
Overview
OpenCode is an open source AI coding agent that works from your terminal. You install it as a command-line tool and use it to explore, write, and change code in your projects.
It ships with two built-in agents you switch between using the Tab key: a full-access build agent for development work, and a read-only plan agent for analysis and code exploration. A general subagent handles complex searches and multistep tasks.

Beyond the terminal, OpenCode also offers a beta desktop application for macOS, Windows, and Linux, so you can use the same agent through a graphical app.
OpenCode 2.0 runs the agent as one background service that the terminal, web and desktop clients all connect to. It adds a rebuilt server API, a Code Mode that chains tool calls in one script, background subagents and shell commands, hot-reloadable plugins, and an SDK for using OpenCode as a library.
What it does
- Runs as a terminal-based AI coding agent you install once and use across projects
- Built-in build agent with full access for hands-on development work
- Read-only plan agent that denies file edits and asks before running bash commands, good for exploring unfamiliar code
- General subagent for complex searches and multistep tasks, callable with @general in messages
- Switch between agents instantly with the Tab key
- Optional beta desktop app for macOS, Windows, and Linux alongside the CLI
- Desktop plugins (experimental since 2.2.0) that users can create, install and share
Getting started
OpenCode installs as a command-line tool. You can use the install script, a package manager, or a platform-specific installer, then run it inside any project directory.
Install with the script
The quickest way is the official install script, which picks an install directory automatically.
curl -fsSL https://opencode.ai/install | bashOr install with a package manager
OpenCode is published to npm and several other package managers, so you can use the one that fits your setup.
npm i -g @opencode/cli@latest # or bun/pnpm/yarn
brew install anomalyco/tap/opencode # macOS and Linux
scoop install opencode # WindowsSwitch agents while you work
Once running, press Tab to switch between the build agent (full access) and the plan agent (read-only). Use @general in a message to call the general subagent for complex searches and multistep tasks.
Commands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Writing and editing code in a project directly from the terminal with the full-access build agent
- Exploring an unfamiliar codebase or planning changes safely with the read-only plan agent
- Running complex searches and multistep tasks through the general subagent
- Using the same coding agent through a desktop app on macOS, Windows, or Linux
Version history
Every verified update to opencode that AI/TLDR tracked, newest first — each links to our coverage and the official changeset.
- 2026-10-27v2.2.0
OpenCode 2.2.0 adds experimental desktop plugins that users can create, install and share, a redesigned desktop app, and prompt cache TTLs set per provider or model. The OpenCode GitHub Action is no longer published, and TUI plugins now need OpenTUI 0.7.
- 2026-10-12v2.0
OpenCode 2.0 runs as one background service shared by the terminal, web and desktop apps, with a rebuilt API, Code Mode, background subagents and an SDK. Version 1 plugins and server API integrations must be ported.
opencode in the news
- 2026-10-27NOTABLEOpenCode 2.2.0 — desktop plugins and a redesigned desktop app
- 2026-10-17MAJOROpenCode Console breach — users told to rotate OpenAI and Anthropic keys
- 2026-10-12MAJOROpenCode 2.0 — the open-source coding agent becomes a background service
- 2026-10-07NOTABLEWhy isn't the industry freaking out about DeepSeek 4.1 Flash? — one dev's month
- 2026-09-26NOTABLEDrawgent — your coding agent draws on a live Excalidraw canvas
- 2026-09-11NOTABLERTK does not cut AI coding costs — Quesma's Terminal-Bench 2.1 run
- 2026-08-10NOTABLEOpenChamber 1.18.2 — agent workspace adds scheduled tasks and a live panel
- 2026-07-31MAJORQM — Y Combinator open-sources the multi-agent harness it runs internally
From the AI/TLDR release feed — every item is source-verified when it ships.
How opencode compares
opencode alongside other open-source autonomous coding agents tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| opencode | ★ 224k | The open source AI coding agent for your terminal |
| Claude Code | ★ 154k | Anthropic's agentic coding tool for the terminal, IDE and GitHub: it understands your codebase, executes routine tasks, explains code and handles git workflows from natural-language commands. |
| OpenAI Codex | ★ 133k | OpenAI's cloud and CLI coding agent that writes features, fixes bugs, and proposes code changes across a repo, running tasks in parallel. |
| Pi | ★ 120k | Minimal terminal coding agent harness with four built-in tools, extended through TypeScript extensions, skills and prompt templates instead of forks. |
| Orca | ★ 115k | Open-source desktop workspace that runs Claude Code, Codex, OpenCode and other CLI coding agents in parallel, each in its own git worktree, with a mobile companion app. |
| Gemini CLI | ★ 109k | An open-source command-line AI agent from Google that connects your terminal to Gemini models for reading code, editing files, running shell commands, and searching the web. |
| autoresearch | ★ 99.2k | Karpathy's minimal harness that hands a coding agent a single-GPU LLM training script and lets it run fixed five-minute experiments, keeping or discarding each change on its own. |
| OpenHands | ★ 92.6k | An open-source AI software-development agent that plans tasks, edits files, runs commands, and tests code, usable from a terminal CLI, a local web GUI, or a Python SDK. |

