OpenCode

At a Glance:

OpenCode is an open-source AI coding agent available as a CLI tool and desktop application, featuring built-in agents for development work and read-only code exploration.

Overview:

OpenCode is an open-source AI coding agent designed to assist with software development tasks. It provides both a command-line interface and a desktop application (currently in beta) across macOS, Windows, and Linux platforms. The tool includes multiple built-in agents that can be switched between during use: a default full-access agent for active development and a read-only agent for analysis and code exploration. A general-purpose subagent is also included for complex, multi-step search tasks. OpenCode runs locally and is distributed as a standalone application, giving developers direct control over their coding environment.

Key Decision Points:

• Dual-agent system: The default agent has full access for development work, while the read-only agent denies file edits and requests permission before running commands, suiting different stages of a developer’s workflow.

• Cross-platform availability: OpenCode is packaged for macOS (Apple Silicon and Intel), Windows, and Linux, with .deb, .rpm, and AppImage formats for Linux users.

• Local installation: The tool is installed directly on a user's machine with configurable installation directories, supporting custom paths, XDG-compliant locations, and user bin directories.

• Subagent for search tasks: A general subagent handles complex searches and multi-step tasks internally, accessible through the @general command in messages.

Core Features:

• Agent switching: Switch between the build and plan agents using the Tab key during a session.

• Read-only analysis agent: The plan agent denies file edits by default and asks permission before executing bash commands, making it suitable for exploring unfamiliar codebases or planning changes.

• General subagent: A dedicated subagent for complex searches and multi-step tasks, invocable with the @general command.

• Desktop application (beta): A graphical desktop app is available directly from the releases page or the project website.

• Configurable installation path: The install script respects OPENCODE_INSTALL_DIR, XDG_BIN_DIR, HOME/bin, and HOME/.opencode/bin in priority order.

Use Cases:

• Developers who want an AI agent to actively write and edit code during development sessions can use the build agent with full file access.

• Developers exploring unfamiliar codebases or planning architectural changes can switch to the read-only plan agent to analyze code without risk of unintended modifications.

• Users running complex multi-step search tasks across a codebase can offload that work to the general subagent invoked through inline commands.

Open-Source Alternative Value:

As an open-source AI coding agent, OpenCode provides a locally installed tool that developers can use for both interactive development and read-only code exploration. Its multi-agent architecture—separating full-access development from permission-gated analysis—gives users fine-grained control over what actions the agent can take. The tool runs on all major desktop platforms and supports configurable installation paths, making it adaptable to different local development setups. Users who prefer an open-source coding agent with local execution and distinct operational modes for editing and analysis will find it a practical option.