OpenCode: The Open Source AI Coding Agent for Enhanced Development

Introduction

OpenCode is a highly popular open-source AI coding agent, designed to assist developers in various programming tasks. Written in TypeScript, this project by anomalyco has garnered significant attention, boasting over 164,000 stars and nearly 20,000 forks on GitHub. OpenCode aims to streamline development workflows, offering intelligent assistance for everything from code analysis to building complex projects. It's a powerful tool for enhancing productivity and exploring codebases efficiently.

Installation

OpenCode offers multiple installation methods to suit different environments, including a command-line interface (CLI) and a desktop application.

CLI Installation:

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

# Package Managers
npm i -g opencode-ai@latest        # or bun/pnpm/yarn
scoop install opencode             # Windows
choco install opencode             # Windows
brew install anomalyco/tap/opencode # macOS and Linux (recommended, always up-to-date)
brew install opencode              # macOS and Linux (official brew formula, less frequent updates)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-bin               # Arch Linux (Latest from AUR)
mise use -g opencode               # Any system
nix run nixpkgs#opencode           # or github:anomalyco/opencode for latest dev branch

Tip: Delete older versions of 0.1.x before installing.

Desktop Application (BETA):

OpenCode is also available as a desktop application. Download directly from the releases page or from opencode.ai/download.

macOS (Apple Silicon): opencode-desktop-mac-arm64.dmg
macOS (Intel): opencode-desktop-mac-x64.dmg
Windows: opencode-desktop-windows-x64.exe
Linux: .deb or .rpm or AppImage

# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktop

Installation Directory:

The installation script respects the following priority for the installation path:

$OPENCODE_INSTALL_DIR - Custom installation folder
$XDG_BIN_DIR - XDG Base Directory specification compliant path
$HOME/bin - Standard user binaries folder (if it exists or can be created)
$HOME/.opencode/bin - Fallback default path

# Examples
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash

Examples

OpenCode includes built-in agents that cater to different development needs. You can easily switch between them using the Tab button within the application.

build: This is the default agent, offering full permissions for development tasks. It's ideal for actively building and modifying projects.
plan: A read-only agent designed for code analysis and exploration. It defaults to refusing file modifications and requests permission before running bash commands, making it perfect for exploring unfamiliar codebases or planning changes without risk.
general: This sub-agent is used internally for complex search and multi-step tasks. It can be invoked by typing @general in messages.

These agents provide a flexible way to interact with your codebase, whether you're deep in development or just trying to understand a new project.

Why Use OpenCode?

OpenCode offers a compelling suite of features that make it an invaluable tool for modern developers. Its AI-powered capabilities accelerate coding, debugging, and code exploration. Being open-source, it benefits from community contributions and transparency. The specialized agents, build and plan, provide tailored experiences for different stages of development, from active coding to safe code analysis. With extensive documentation and a supportive community, OpenCode empowers you to work more efficiently and effectively across various platforms.