Open Code Dev Skill

Based on opencode v1.7.1

Architecture Overview

opencode/                  ← REFERENCE CODEBASE (https://github.com/opencode-ai/opencode)
├── packages/tui/src/     TUI core (Solid.js + @opentui)
├── packages/sdk/js/src/  SDK v1 + v2 clients
├── packages/server/src/  Express + Effect HttpApi server
└── packages/opencode/    CLI + core logic

Tech Stack

Provider Tree (from outermost to innermost)

ExitProvider → EpilogueProvider → ErrorBoundary → TuiPathsProvider
→ TuiTerminalEnvironmentProvider → TuiStartupProvider → ClipboardProvider
→ OpencodeKeymapProvider → ArgsProvider → KVProvider → ToastProvider
→ RouteProvider → TuiConfigProvider → PluginRuntimeProvider
→ SDKProvider → ProjectProvider → SyncProvider (V1 events)
→ SyncProviderV2 (V2 events) → ThemeProvider → LocalProvider
→ PromptStashProvider → DialogProvider → FrecencyProvider
→ PromptHistoryProvider → PromptRefProvider → EditorContextProvider → <App />

1. Initialization Flow

Entry Point

packages/tui/src/app.tsx — run() (Effect function):

export const run = Effect.fn("Tui.run")(function* (input: TuiInput) {
  // input.url      — server base URL
  // input.args     — CLI args
  // input.config   — TuiConfig.Resolved
  // input.fetch    — custom fetch
  // input.headers  — custom headers
  // input.events   — EventSource
  // input.pluginHost — TuiPluginHost
})

Bootstrap (SyncProvider) — packages/tui/src/context/sync.tsx

Blocking (UI waits):

• sdk.client.config.providers() → provider[]
• sdk.client.provider.list() → provider_next
• sdk.client.app.agents() → agent[]
• sdk.client.config.get() → config
• project.sync() → project info
• If -c mode: session.list()

Non-blocking (background):

• session.list(), command.list(), lsp.status(), mcp.status()
• formatter.status(), session.status(), provider.auth(), vcs.get()

Status flow: "loading" → "partial" → "complete"

SDK Connection (SDKProvider) — packages/tui/src/context/sdk.tsx

1. createOpencodeClient({ baseUrl }) creates HTTP client
2. SSE starts via sdk.global.event() — infinite stream with exponential backoff reconnect (1s → 30s max)
3. Events batched in 16ms window, then single batch() render

Module Loader

This skill is split into modular files for on-demand loading. Read the relevant file based on what the user needs: