OpenCode
A local coding agent with full-access build and read-only plan modes; the desktop app remains beta.
What it is
OpenCode is an open-source AI coding agent installed on your own machine. After starting it, you can have it inspect the codebase, analyze problems, and propose changes in the terminal, then edit files or run engineering commands according to the selected mode; it also offers a desktop app that is still in Beta.
A typical workflow starts by getting oriented in an unfamiliar project in plan mode. In this mode file edits are denied by default, and running Bash commands requires permission first. Once the plan is confirmed, press Tab to switch to build mode and apply the changes. Compared with copying code into an ordinary chat tool, OpenCode works directly around the local codebase and engineering commands; compared with an agent that always holds write permission, it separates analysis and execution into modes with different permissions.
How to run
The README provides an install script and several package manager entries; pick any one and run it:
curl -fsSL https://opencode.ai/install | bash
npm i -g opencode-ai@latest
brew install anomalyco/tap/opencodeAfter installation, start OpenCode from the terminal. Desktop versions can also be downloaded for macOS, Windows, and Linux, though that entry point is still marked Beta. If a version older than 0.1.x is already installed, remove the old version first and then reinstall.
Core mechanics
- build mode: the default Agent, with full permissions to complete development work, used for editing files and implementing project changes.
- plan mode: used for analysis and code exploration, denies file edits by default, and requests permission before running Bash commands.
- Mode switching: press
Tabin the interface to switch between build and plan, keeping exploration and execution within different permission boundaries. - General subagent: complex searches or multi-step tasks can use the built-in subagent, and can also be invoked in a message via
@general.
Who it is for
It suits developers who want to move continuously through codebase reading, planning, and file changes in the terminal, while clearly distinguishing read-only analysis from write operations. When working on an unfamiliar project, you can first confirm the structure and the scope of changes in plan, then switch to build to execute.
Boundaries
The project source uses the MIT license and can be installed and maintained on your own machine. plan provides default permission limits and does not replace confirming the task; build has full development permissions, so before switching you should still confirm whether the current task allows writing files. The desktop app is still in Beta. The README sections that were read do not state model credentials, model service costs, or offline inference capability, so this cannot be used to conclude that it needs no external model service.