Overview

OpenCode is being added as a community AI assistant provider for Archon. This issue tracks the implementation progress and serves as a central reference for the two open PRs.

Related PRs

• feat: add OpenCode community provider #1372 — feat: add OpenCode community provider (by choufeng)

  • Base provider implementation using @opencode-ai/sdk
  • Supports: session resume, MCP, skills, tool restrictions, structured output, env injection, effort/thinking control
  • Status: OPEN

• feat(providers): add OpenCode community provider with agents support #1384 — feat(providers): add OpenCode community provider with agents support (by cropse)

  • Adds agent adaptation layer mapping nodeConfig.agents to OpenCode's runtime API
  • Status: DRAFT

Motivation

Users have requested the ability to use OpenCode as an alternative to Claude Code within Archon workflows (see closed issue #1151). The adapters pattern allows Archon to remain CLI-agnostic while keeping Claude Code as the default.

Architecture (from PR #1372 design doc)

OpenCode is a client/server AI coding agent (unlike Claude Code/Codex which are monolithic CLIs). The provider:

1. Lazy-starts an OpenCode Server (opencode serve) on first use with lifecycle management
2. Connects via @opencode-ai/sdk using createOpencodeClient
3. Bridges SSE events to Archon's MessageChunk async generator contract
4. Manages session lifecycle (create/resume/abort) via SDK

Key files

packages/providers/src/community/opencode/
├── provider.ts              # OpenCodeProvider class
├── capabilities.ts          # OPENCODE_CAPABILITIES
├── config.ts                # parseOpencodeConfig
├── server-manager.ts        # OpenCode Server lifecycle
├── event-bridge.ts          # SSE Event → MessageChunk
├── registration.ts          # registerOpencodeProvider()
├── index.ts                 # Public exports
├── provider.test.ts         # Tests
└── config.test.ts           # Config tests

Event Bridge Mapping

What's Implemented

Configuration

# .archon/config.yaml
assistants:
  opencode:
    model: anthropic/claude-sonnet-4
    hostname: 127.0.0.1
    port: 4096
    autoStartServer: true

Reference: OpenCode Repo Structure

The OpenCode provider connects to anomalyco/opencode which has:

• SDK: packages/sdk/js/ — createOpencodeClient factory, v2 client
• Provider system: packages/opencode/src/provider/ — auth, models, schema
• ACP (Agent Communication Protocol): packages/opencode/src/acp/ — agent, session, types
• MCP server support, skill system, and agent interface already built in

Next Steps

• Review and merge feat: add OpenCode community provider #1372 (base provider)
• Finalize feat(providers): add OpenCode community provider with agents support #1384 (agent support) and convert to ready state
• Add E2E smoke workflow documentation