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
| Layer |
Tech |
| TUI |
Solid.js + @opentui/solid + @opentui/core |
| State |
solid-js/store (createStore, produce, reconcile) |
| Events |
SSE (Server-Sent Events) + local EventEmitter |
| HTTP Client |
@hey-api/openapi-ts generated client |
| Server |
Effect HttpApi (declarative HTTP API framework) |
| SDK types |
@opencode-ai/sdk v1 in dist/gen/types.gen.d.ts |
| Build |
Turborepo monorepo |
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_nextsdk.client.app.agents() → agent[]sdk.client.config.get() → configproject.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
createOpencodeClient({ baseUrl }) creates HTTP client- SSE starts via
sdk.global.event() — infinite stream with exponential backoff reconnect (1s → 30s max)
- 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:
| If the user asks about... |
Load this file |
| Session data model, SDK methods, sync, status, routes, keyboard commands |
SESSION.md |
| Message types, parts, tool state machine, tool→render mapping, V2 event stream |
SESSION.md |
| Permission approval flow, SDK reply, PermissionPrompt UI |
PERMISSION.md |
| Question dialog flow, SDK reply/reject, store structure |
PERMISSION.md |
| Project, provider & model types, auth (API key, OAuth) |
PROVIDER.md |
| Agent system, agent store |
PROVIDER.md |
| Sync store full structure, event update pattern, local store |
SYNC.md |
| SSE event catalog (V1 + V2) |
SYNC.md |
| TUI control API (appendPrompt, showToast, etc.) |
API.md |
| File, Find, MCP, PTY, VCS, LSP SDK methods |
API.md |
| Console, account, org management |
API.md |
| OpenAPI endpoint reference |
API.md |
| SDK client creation, request/response, structured output, error types |
API.md |
| Key TUI file index |
INDEX.md |
| Behavioral guidelines for implementation |
INDEX.md |
1---2name: opencode-dev3description: Universal Open Code development skill. Use whenever the user asks to build, modify, debug, or understand any feature of the Open Code TUI (desktop or CLI). Covers session management, message streaming, permission approval, question dialogs, project management, provider/model config, SSE event handling, account/org management, MCP, VCS, file ops, and the full SDK/OpenAPI surface. ALSO use when the user asks about code structure, data flow, or how any part of Open Code works — this skill contains the complete "answer key" so you don't need to re-research. Trigger on phrases like "opencode feature", "TUI component", "build a session view", "approval flow", "SDK API", "opencode integration", "add a new API endpoint", "how does X work in opencode".4---56# Open Code Dev Skill78> Based on opencode v1.7.1910## Architecture Overview1112```13opencode/ ← REFERENCE CODEBASE (https://github.com/opencode-ai/opencode)14├── packages/tui/src/ TUI core (Solid.js + @opentui)15├── packages/sdk/js/src/ SDK v1 + v2 clients16├── packages/server/src/ Express + Effect HttpApi server17└── packages/opencode/ CLI + core logic18```1920### Tech Stack21| Layer | Tech |22|-------|------|23| TUI | Solid.js + `@opentui/solid` + `@opentui/core` |24| State | `solid-js/store` (createStore, produce, reconcile) |25| Events | SSE (Server-Sent Events) + local EventEmitter |26| HTTP Client | `@hey-api/openapi-ts` generated client |27| Server | Effect `HttpApi` (declarative HTTP API framework) |28| SDK types | `@opencode-ai/sdk` v1 in `dist/gen/types.gen.d.ts` |29| Build | Turborepo monorepo |3031### Provider Tree (from outermost to innermost)32```33ExitProvider → EpilogueProvider → ErrorBoundary → TuiPathsProvider34→ TuiTerminalEnvironmentProvider → TuiStartupProvider → ClipboardProvider35→ OpencodeKeymapProvider → ArgsProvider → KVProvider → ToastProvider36→ RouteProvider → TuiConfigProvider → PluginRuntimeProvider37→ SDKProvider → ProjectProvider → SyncProvider (V1 events)38→ SyncProviderV2 (V2 events) → ThemeProvider → LocalProvider39→ PromptStashProvider → DialogProvider → FrecencyProvider40→ PromptHistoryProvider → PromptRefProvider → EditorContextProvider → <App />41```4243---4445## 1. Initialization Flow4647### Entry Point48`packages/tui/src/app.tsx` — `run()` (Effect function):49```typescript50export const run = Effect.fn("Tui.run")(function* (input: TuiInput) {51 // input.url — server base URL52 // input.args — CLI args53 // input.config — TuiConfig.Resolved54 // input.fetch — custom fetch55 // input.headers — custom headers56 // input.events — EventSource57 // input.pluginHost — TuiPluginHost58})59```6061### Bootstrap (SyncProvider) — `packages/tui/src/context/sync.tsx`62**Blocking** (UI waits):63- `sdk.client.config.providers()` → provider[]64- `sdk.client.provider.list()` → provider_next65- `sdk.client.app.agents()` → agent[]66- `sdk.client.config.get()` → config67- `project.sync()` → project info68- If `-c` mode: `session.list()`6970**Non-blocking** (background):71- `session.list()`, `command.list()`, `lsp.status()`, `mcp.status()`72- `formatter.status()`, `session.status()`, `provider.auth()`, `vcs.get()`7374Status flow: `"loading"` → `"partial"` → `"complete"`7576### SDK Connection (SDKProvider) — `packages/tui/src/context/sdk.tsx`771. `createOpencodeClient({ baseUrl })` creates HTTP client782. SSE starts via `sdk.global.event()` — infinite stream with exponential backoff reconnect (1s → 30s max)793. Events batched in 16ms window, then single `batch()` render8081## Module Loader8283This skill is split into modular files for on-demand loading. Read the relevant file based on what the user needs:8485| If the user asks about... | Load this file |86|---|---|87| Session data model, SDK methods, sync, status, routes, keyboard commands | `SESSION.md` |88| Message types, parts, tool state machine, tool→render mapping, V2 event stream | `SESSION.md` |89| Permission approval flow, SDK reply, PermissionPrompt UI | `PERMISSION.md` |90| Question dialog flow, SDK reply/reject, store structure | `PERMISSION.md` |91| Project, provider & model types, auth (API key, OAuth) | `PROVIDER.md` |92| Agent system, agent store | `PROVIDER.md` |93| Sync store full structure, event update pattern, local store | `SYNC.md` |94| SSE event catalog (V1 + V2) | `SYNC.md` |95| TUI control API (appendPrompt, showToast, etc.) | `API.md` |96| File, Find, MCP, PTY, VCS, LSP SDK methods | `API.md` |97| Console, account, org management | `API.md` |98| OpenAPI endpoint reference | `API.md` |99| SDK client creation, request/response, structured output, error types | `API.md` |100| Key TUI file index | `INDEX.md` |101| Behavioral guidelines for implementation | `INDEX.md` |
SoulChildTc