# anomalyco/opencode architecture

> Architecture diagram of the GitHub repository anomalyco/opencode, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anomalyco/opencode
- Repository: https://github.com/anomalyco/opencode
- Video tour (about a minute): https://gitdiagram.com/anomalyco/opencode/video

## Overview

OpenCode is an open-source AI coding agent, used through its terminal and desktop experiences. A typical user starts or opens a coding session, composes a request, and gets agent responses and code changes to review. The repository separates user interfaces, server/API orchestration, shared client and domain services, and provider-facing AI execution. The README documents build/plan agents and a general subagent; sampled source shows AI request execution, server service composition, persistence, and review UI, but does not establish every session-to-agent call path.

Main entry points: [`packages/server/src/routes.ts`](https://github.com/anomalyco/opencode/blob/dev/packages/server/src/routes.ts) (HTTP server), [`packages/ai/src/route/executor.ts`](https://github.com/anomalyco/opencode/blob/dev/packages/ai/src/route/executor.ts) (Request executor), [`packages/app/src/app.tsx`](https://github.com/anomalyco/opencode/blob/dev/packages/app/src/app.tsx) (Web app), [`packages/tui/src/app.tsx`](https://github.com/anomalyco/opencode/blob/dev/packages/tui/src/app.tsx) (Terminal UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experiences"]
  node_tui["Terminal UI<br/>[app.tsx]"]
  node_desktop["Desktop app<br/>[storage.ts]"]
  node_app["Web app<br/>[app.tsx]"]
end

subgraph group_workflow["Coding workflow"]
  node_session_home["Session browser<br/>[controller.tsx]"]
  node_composer["Prompt composer<br/>[submit.ts]"]
  node_agents["Agent modes"]
  node_review["Change review<br/>[session-review.tsx]"]
end

subgraph group_services["Application services"]
  node_server["HTTP server<br/>[routes.ts]"]
  node_core["Core services<br/>[app.ts]"]
  node_client["Client service<br/>[service.ts]"]
  node_protocol["API protocol<br/>[server.ts]"]
  node_app_state[("App persistence<br/>[storage.ts]")]
  node_desktop_state[("Desktop storage<br/>[state.ts]")]
end

subgraph group_ai["AI execution"]
  node_ai_api["AI client API"]
  node_ai_schema["AI schemas<br/>[messages.ts]"]
  node_ai_executor["Request executor<br/>[executor.ts]"]
  node_ai_providers["Provider adapters"]
end

node_user(("Developer"))
node_external_models{{"AI providers"}}

node_user -->|"uses"| node_tui
node_user -->|"uses"| node_desktop
node_user -.->|"uses"| node_app
node_user -->|"selects agent"| node_agents
node_tui -->|"uses"| node_client
node_client -.->|"uses"| node_protocol
node_app -.->|"opens sessions"| node_session_home
node_session_home -.->|"starts requests"| node_composer
node_composer -.->|"submits request"| node_server
node_server -->|"composes services"| node_core
node_server -.->|"provides API"| node_ai_executor
node_ai_api -->|"executes via"| node_ai_executor
node_ai_executor -->|"uses types"| node_ai_schema
node_ai_executor -.->|"dispatches requests"| node_ai_providers
node_ai_providers -.->|"calls models"| node_external_models
node_server -.->|"uses AI services"| node_external_models
node_app -.->|"persists state"| node_app_state
node_desktop -->|"reads and writes"| node_desktop_state
node_review -.->|"presents changes"| node_user

click node_tui "https://github.com/anomalyco/opencode/blob/dev/packages/tui/src/app.tsx"
click node_desktop "https://github.com/anomalyco/opencode/blob/dev/packages/desktop/src/main/ipc-handlers/storage.ts"
click node_app "https://github.com/anomalyco/opencode/blob/dev/packages/app/src/app.tsx"
click node_session_home "https://github.com/anomalyco/opencode/blob/dev/packages/app/src/home/sessions/controller.tsx"
click node_composer "https://github.com/anomalyco/opencode/blob/dev/packages/app/src/composer/submit.ts"
click node_agents "https://github.com/anomalyco/opencode/tree/dev/packages/core/src"
click node_review "https://github.com/anomalyco/opencode/blob/dev/packages/session-ui/src/components/session-review.tsx"
click node_server "https://github.com/anomalyco/opencode/blob/dev/packages/server/src/routes.ts"
click node_core "https://github.com/anomalyco/opencode/blob/dev/packages/core/src/app.ts"
click node_client "https://github.com/anomalyco/opencode/blob/dev/packages/client/src/effect/service.ts"
click node_protocol "https://github.com/anomalyco/opencode/blob/dev/packages/protocol/src/groups/server.ts"
click node_app_state "https://github.com/anomalyco/opencode/blob/dev/packages/app/src/runtime/persistence/storage.ts"
click node_desktop_state "https://github.com/anomalyco/opencode/blob/dev/packages/desktop/src/main/storage/state.ts"
click node_ai_api "https://github.com/anomalyco/opencode/blob/dev/packages/ai/src/embedding-client.ts"
click node_ai_schema "https://github.com/anomalyco/opencode/blob/dev/packages/ai/src/schema/messages.ts"
click node_ai_executor "https://github.com/anomalyco/opencode/blob/dev/packages/ai/src/route/executor.ts"
click node_ai_providers "https://github.com/anomalyco/opencode/tree/dev/packages/ai/src/providers"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_tui,node_desktop,node_app toneBlue
class node_session_home,node_composer,node_agents,node_review toneAmber
class node_server,node_core,node_client,node_protocol,node_app_state,node_desktop_state toneMint
class node_ai_api,node_ai_schema,node_ai_executor,node_ai_providers toneRose
class node_user,node_external_models toneIndigo
```

## Components

### User experiences

- [Terminal UI](https://github.com/anomalyco/opencode/blob/dev/packages/tui/src/app.tsx): `packages/tui/src/app.tsx`
- [Desktop app](https://github.com/anomalyco/opencode/blob/dev/packages/desktop/src/main/ipc-handlers/storage.ts): `packages/desktop/src/main/ipc-handlers/storage.ts`
- [Web app](https://github.com/anomalyco/opencode/blob/dev/packages/app/src/app.tsx): `packages/app/src/app.tsx`

### Coding workflow

- [Session browser](https://github.com/anomalyco/opencode/blob/dev/packages/app/src/home/sessions/controller.tsx): `packages/app/src/home/sessions/controller.tsx`
- [Prompt composer](https://github.com/anomalyco/opencode/blob/dev/packages/app/src/composer/submit.ts): `packages/app/src/composer/submit.ts`
- [Agent modes](https://github.com/anomalyco/opencode/tree/dev/packages/core/src): `packages/core/src`
- [Change review](https://github.com/anomalyco/opencode/blob/dev/packages/session-ui/src/components/session-review.tsx): `packages/session-ui/src/components/session-review.tsx`

### Application services

- [HTTP server](https://github.com/anomalyco/opencode/blob/dev/packages/server/src/routes.ts): `packages/server/src/routes.ts`
- [Core services](https://github.com/anomalyco/opencode/blob/dev/packages/core/src/app.ts): `packages/core/src/app.ts`
- [Client service](https://github.com/anomalyco/opencode/blob/dev/packages/client/src/effect/service.ts): `packages/client/src/effect/service.ts`
- [API protocol](https://github.com/anomalyco/opencode/blob/dev/packages/protocol/src/groups/server.ts): `packages/protocol/src/groups/server.ts`
- [App persistence](https://github.com/anomalyco/opencode/blob/dev/packages/app/src/runtime/persistence/storage.ts): `packages/app/src/runtime/persistence/storage.ts`
- [Desktop storage](https://github.com/anomalyco/opencode/blob/dev/packages/desktop/src/main/storage/state.ts): `packages/desktop/src/main/storage/state.ts`

### AI execution

- [AI client API](https://github.com/anomalyco/opencode/blob/dev/packages/ai/src/embedding-client.ts): `packages/ai/src/embedding-client.ts`
- [AI schemas](https://github.com/anomalyco/opencode/blob/dev/packages/ai/src/schema/messages.ts): `packages/ai/src/schema/messages.ts`
- [Request executor](https://github.com/anomalyco/opencode/blob/dev/packages/ai/src/route/executor.ts): `packages/ai/src/route/executor.ts`
- [Provider adapters](https://github.com/anomalyco/opencode/tree/dev/packages/ai/src/providers): `packages/ai/src/providers`

### Other components

- **Developer**
- **AI providers**

## Connections

- Developer → Terminal UI: uses (evidence: `README.md`)
- Developer → Desktop app: uses (evidence: `README.md`)
- Developer → Web app: uses
- Developer → Agent modes: selects agent (evidence: `README.md`)
- Terminal UI → Client service: uses (evidence: `packages/tui/src/app.tsx`)
- Client service → API protocol: uses
- Web app → Session browser: opens sessions
- Session browser → Prompt composer: starts requests
- Prompt composer → HTTP server: submits request
- HTTP server → Core services: composes services (evidence: `packages/server/src/routes.ts`)
- HTTP server → Request executor: provides API
- AI client API → Request executor: executes via (evidence: `packages/ai/src/embedding-client.ts`)
- Request executor → AI schemas: uses types (evidence: `packages/ai/src/route/executor.ts`)
- Request executor → Provider adapters: dispatches requests
- Provider adapters → AI providers: calls models
- HTTP server → AI providers: uses AI services
- Web app → App persistence: persists state
- Desktop app → Desktop storage: reads and writes (evidence: `packages/desktop/src/main/ipc-handlers/storage.ts`)
- Change review → Developer: presents changes
