opencode — Open-source AI coding agent with dual build/read agents

Project Overview

OpenCode has been a quiet sensation in the developer tools space, accumulating over 156,000 stars on GitHub[1] — a figure that signals genuine utility rather than hype. Written in TypeScript, it positions itself as an open-source AI coding agent, a category that has seen explosive growth but surprisingly few truly open alternatives. What distinguishes OpenCode from the pack is its architectural choice to offer two distinct agents: a full-access ‘build’ agent for active development and a read-only ‘plan’ agent for exploration. This split reflects a thoughtful design philosophy — recognizing that the same AI that confidently edits files should not be the one you use to understand unfamiliar code. The project has been iterating rapidly, with releases like v1.14.40[2] appearing frequently, suggesting an active development cycle that prioritizes incremental improvement over grand, infrequent releases.

What It’s For

OpenCode solves a specific tension in AI-assisted development: the conflict between autonomy and safety. When you need to explore a codebase you didn’t write, the last thing you want is an AI agent making assumptions and changing files. The ‘plan’ agent addresses this by denying file edits by default and asking permission before executing bash commands[3], making it suitable for code review, architecture analysis, or onboarding to unfamiliar projects. Conversely, the ‘build’ agent provides unrestricted access for developers who trust their AI tooling and want maximum velocity. This dual-agent approach makes OpenCode relevant across the spectrum of development workflows — from the cautious newcomer exploring a monorepo to the experienced developer refactoring code they own. It’s worth noting that the project also includes a ‘general’ subagent for complex multistep searches, invoked via @general[3], which adds a third layer of capability for tasks that don’t fit neatly into the primary agent paradigm.

How to Use It

OpenCode is primarily distributed via npm as the package ‘opencode-ai’, but the installation story is refreshingly flexible — supporting everything from a YOLO curl script to Homebrew, Scoop, Chocolatey, Pacman, Mise, and even Nix. This breadth of distribution options suggests the maintainers understand that installation friction is a real barrier to adoption. The desktop app, currently in beta, extends the CLI experience with a graphical interface, available for macOS (both Apple Silicon and Intel), Windows, and Linux via .deb, .rpm, or AppImage formats[4]. The core workflow involves switching between the ‘build’ and ‘plan’ agents using the Tab key, which is an elegant interaction pattern that avoids configuration overhead. For complex tasks, you can invoke the general subagent by typing @general in your messages[3].

Installs the latest version of OpenCode globally via npm, making it available as a command-line tool.

npm i -g opencode-ai@latest

Installs OpenCode on macOS or Linux using the maintainer’s Homebrew tap, which stays more current than the official formula.

brew install anomalyco/tap/opencode

The quickstart installation method using a shell script fetched from the project’s official site.

curl -fsSL https://opencode.ai/install | bash

Recent Updates

Latest Release: v1.14.40 (2026-02-13)

Latest in a rapid release cadence, continuing refinements to the agent system and CLI experience.

The project shows high commit velocity with releases appearing almost daily in the v1.14.x range[2], indicating active maintenance and feature iteration. The star count growth to 156,084[1] suggests strong community interest, though the desktop app remains in beta, which may limit adoption for users who prefer GUI-based tools over terminal interfaces.


Sources & Attributions

[1] 156,084 stars on GitHub as of the provided data — anomalyco/opencode [2] Version v1.14.40 listed as the most recent release — anomalyco/opencode@v1.14.40 [3] Plan agent behavior and @general subagent invocation from README — anomalyco/opencode [4] Desktop app beta availability and platform downloads from README — anomalyco/opencode