OpenCode
An open source coding agent for the terminal and desktop with build and plan modes
Install
curl -fsSL https://opencode.ai/install | bashInstall script.
This is third-party code. Review the repository files before installing.
What it does
OpenCode runs in the terminal as an agent that reads and edits project code and runs commands. It has two built-in modes switched with Tab: build with full access for development, and read-only plan that does not edit files and asks before running commands. A general subagent handles complex searches and multi-step tasks. Besides the terminal UI there is a desktop app in beta.
Who it is for. For developers who want an open source terminal agent not tied to a single vendor.
Good fit when
- You want an open source coding agent
- You need to explore an unfamiliar codebase safely in read-only mode first
- You want the same agent in the terminal and a desktop app
Not a fit when
- You need an agent built into the IDE without a terminal
- You have no access to any model provider
Example request
Switch to plan mode, study the project structure and propose a refactoring plan for the auth moduleLimitations
The agent is free, but models are connected separately; providers and setup are covered in the docs. Whether it works without a VPN depends on the provider. Build mode gives the agent full file and command access by default. The desktop app is in beta. Versions older than 0.1.x must be removed before installing.
How to disable. Uninstall with the same package manager you used, e.g. npm uninstall -g opencode-ai or brew uninstall opencode.
Security check
- In build mode it edits files and runs shell commands
- Sends project code to the chosen model provider
README in short
The README lists install options: a script, npm, Homebrew, Scoop, Chocolatey, pacman, mise and Nix, plus desktop builds for macOS, Windows and Linux. It explains install directory resolution and the two built-in modes with the general subagent. Configuration lives in the docs at opencode.ai. The README is translated into about twenty languages, including Russian. MIT licensed.
FAQ
How does plan mode differ from build?
Plan only reads code: file edits are denied and the agent asks before running commands. Build has full access.
Is this the same as opencode-ai/opencode?
No, the old opencode-ai/opencode repository is archived and continued as Crush. This OpenCode previously lived at sst/opencode.
Related
Open-source personal AI assistant on your own machine: answers in Telegram, Slack, Discord and WhatsApp, extended with skills and plugins
A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
Anthropic's coding agent for the terminal, IDE and GitHub: understands your codebase, runs tasks and handles git
OpenAI's coding agent that runs locally in your terminal, with IDE and desktop versions