opencode

OpenCode

Adapters for the OpenCode multi-provider AI coding agent from anomalyco/opencode.

⚠️ Important: This is not the same as the deprecated opencode-ai/opencode GitHub project (now charmbracelet/crush). Adapters supports the anomalyco/opencode implementation, whose canonical npm package is opencode-ai.

Adapter Variants

Adapters provides two OpenCode adapters:

• opencode (subprocess) — Default CLI-based integration
• opencode-http (remote) — HTTP server with SSE streaming for enhanced performance

Choosing an Adapter

Adapter	Type	Use Case	Performance
opencode	Subprocess	General use, simple setup	Standard
opencode-http	Remote (HTTP)	High-performance, real-time streaming	Enhanced

Recommendation: Use opencode-http for production workloads or when performance is critical. Use opencode for simple use cases or debugging.

Install

# Install the CLI (required for both adapters)
adapters install opencode

Install methods:

• npm: npm install -g opencode-ai
• brew (macOS): brew install --cask opencode
• curl: curl -fsSL https://opencode.ai/install | bash

Supported on macOS, Linux and Windows.

Auth

OpenCode supports multiple AI providers. Configure authentication using:

opencode auth

Or set environment variables directly:

• ANTHROPIC_API_KEY — for Claude models
• OPENAI_API_KEY — for GPT models
• GOOGLE_API_KEY — for Gemini models

Config file: ~/.config/opencode/config.json.

Minimal run

CLI Examples

# Subprocess adapter (default)
adapters run opencode --prompt "Add error handling to this function"

# HTTP adapter (enhanced performance)
adapters run opencode-http --prompt "Add error handling to this function"

Programmatic Examples

import { createClient } from '@a5c-ai/adapters';
const client = createClient();

// Subprocess adapter
const handle1 = await client.run({ agent: 'opencode', prompt: 'Refactor this code' });
for await (const ev of handle1.events()) console.log(ev);

// HTTP adapter
const handle2 = await client.run({ agent: 'opencode-http', prompt: 'Refactor this code' });
for await (const ev of handle2.events()) console.log(ev);