# eclipse-theia/theia architecture

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

- Interactive diagram: https://gitdiagram.com/eclipse-theia/theia
- Repository: https://github.com/eclipse-theia/theia

## Overview

Eclipse Theia is a framework for building extensible browser and desktop IDEs. A user-facing AI workflow is represented here from chat input through chat services and agents to language-model providers, with responses rendered in the chat UI. The tree also shows code completion, provider-specific integrations, configuration, and IDE persistence capabilities. The README documents extension mechanisms and VS Code extension support. Source excerpts are limited, so links between unsampled subsystems are kept at a high level; storage edges reflect the sampled implementations.

Main entry points: [`packages/ai-chat/src/browser/frontend-chat-service.ts`](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/browser/frontend-chat-service.ts) (Frontend chat), [`packages/ai-core/src/browser/frontend-language-model-registry.ts`](https://github.com/eclipse-theia/theia/blob/master/packages/ai-core/src/browser/frontend-language-model-registry.ts) (Model registry), [`packages/ai-chat/src/common/chat-agent-service.ts`](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/common/chat-agent-service.ts) (Agent services), [`packages/userstorage/src/browser/user-storage-contribution.ts`](https://github.com/eclipse-theia/theia/blob/master/packages/userstorage/src/browser/user-storage-contribution.ts) (User storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_chat["AI chat"]
  node_chatui["Chat interface"]
  node_chatinput["Chat input"]
  node_frontendchat["Frontend chat"]
  node_chatservice["Chat service<br/>[chat-service.ts]"]
  node_context["Context variables"]
  node_tools["Tool requests"]
  node_render["Response rendering<br/>[index.ts]"]
  node_sessions["Session storage"]
end

subgraph group_models["Models and agents"]
  node_agents["Agent services"]
  node_modelsregistry["Model registry"]
  node_anthropic["Anthropic provider"]
  node_copilot["Copilot provider"]
  node_claudecode["Claude Code agent"]
  node_completion["Inline completion"]
end

subgraph group_ide["IDE integration"]
  node_config["AI configuration"]
  node_extensions["Plugin storage<br/>[plugin-storage.ts]"]
end

subgraph group_state["IDE state"]
  node_preferences["Preference storage"]
  node_localstorage[("Browser storage<br/>[storage-service.ts]")]
  node_taskcontext["Task context"]
  node_taskfiles["Task context files"]
  node_workspace["Workspace metadata"]
  node_userstorage["User storage"]
end

node_user(("IDE user"))

node_user -->|"enters prompt"| node_chatinput
node_chatinput -->|"submits request"| node_frontendchat
node_frontendchat -->|"uses service"| node_chatservice
node_chatservice -->|"selects agent"| node_agents
node_agents -->|"resolves model"| node_modelsregistry
node_frontendchat -->|"collects context"| node_context
node_frontendchat -->|"requests tools"| node_tools
node_chatui -->|"renders response"| node_render
node_frontendchat -->|"stores sessions"| node_sessions
node_modelsregistry -.->|"uses provider"| node_anthropic
node_modelsregistry -.->|"uses provider"| node_copilot
node_agents -.->|"offers agent"| node_claudecode
node_user -->|"requests completion"| node_completion
node_config -->|"configures models"| node_modelsregistry
node_taskcontext -->|"reads task files"| node_taskfiles
node_preferences -->|"uses file storage"| node_userstorage
node_extensions -.->|"persists plugin data"| node_userstorage
node_workspace -.->|"stores workspace data"| node_userstorage

click node_chatui "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat-ui/src/browser/chat-view-widget.tsx"
click node_chatinput "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat-ui/src/browser/chat-input-widget.tsx"
click node_frontendchat "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/browser/frontend-chat-service.ts"
click node_chatservice "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/common/chat-service.ts"
click node_agents "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/common/chat-agent-service.ts"
click node_context "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/common/context-variables.ts"
click node_tools "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/common/chat-tool-request-service.ts"
click node_render "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat-ui/src/browser/chat-response-renderer/index.ts"
click node_sessions "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/browser/chat-session-store-impl.ts"
click node_modelsregistry "https://github.com/eclipse-theia/theia/blob/master/packages/ai-core/src/browser/frontend-language-model-registry.ts"
click node_anthropic "https://github.com/eclipse-theia/theia/blob/master/packages/ai-anthropic/src/node/anthropic-language-model.ts"
click node_copilot "https://github.com/eclipse-theia/theia/blob/master/packages/ai-copilot/src/node/copilot-sdk-language-model.ts"
click node_claudecode "https://github.com/eclipse-theia/theia/blob/master/packages/ai-claude-code/src/browser/claude-code-chat-agent.ts"
click node_completion "https://github.com/eclipse-theia/theia/blob/master/packages/ai-code-completion/src/browser/ai-code-inline-completion-provider.ts"
click node_config "https://github.com/eclipse-theia/theia/tree/master/packages/ai-core-ui/src/browser/ai-configuration"
click node_extensions "https://github.com/eclipse-theia/theia/blob/master/packages/plugin-ext/src/plugin/plugin-storage.ts"
click node_preferences "https://github.com/eclipse-theia/theia/blob/master/packages/preferences/src/browser/frontend-preference-storage.ts"
click node_localstorage "https://github.com/eclipse-theia/theia/blob/master/packages/core/src/browser/storage-service.ts"
click node_taskcontext "https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/browser/task-context-storage-service.ts"
click node_taskfiles "https://github.com/eclipse-theia/theia/blob/master/packages/ai-ide/src/browser/task-context-file-storage-service.ts"
click node_workspace "https://github.com/eclipse-theia/theia/blob/master/packages/workspace/src/browser/metadata-storage/workspace-metadata-storage-service.ts"
click node_userstorage "https://github.com/eclipse-theia/theia/blob/master/packages/userstorage/src/browser/user-storage-contribution.ts"

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_chatui,node_chatinput,node_frontendchat,node_chatservice,node_context,node_tools,node_render,node_sessions,node_user toneBlue
class node_agents,node_modelsregistry,node_anthropic,node_copilot,node_claudecode,node_completion toneAmber
class node_config,node_extensions toneMint
class node_preferences,node_localstorage,node_taskcontext,node_taskfiles,node_workspace,node_userstorage toneRose
```

## Components

### AI chat

- [Chat interface](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat-ui/src/browser/chat-view-widget.tsx): `packages/ai-chat-ui/src/browser/chat-view-widget.tsx`
- [Chat input](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat-ui/src/browser/chat-input-widget.tsx): `packages/ai-chat-ui/src/browser/chat-input-widget.tsx`
- [Frontend chat](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/browser/frontend-chat-service.ts): `packages/ai-chat/src/browser/frontend-chat-service.ts`
- [Chat service](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/common/chat-service.ts): `packages/ai-chat/src/common/chat-service.ts`
- [Context variables](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/common/context-variables.ts): `packages/ai-chat/src/common/context-variables.ts`
- [Tool requests](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/common/chat-tool-request-service.ts): `packages/ai-chat/src/common/chat-tool-request-service.ts`
- [Response rendering](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat-ui/src/browser/chat-response-renderer/index.ts): `packages/ai-chat-ui/src/browser/chat-response-renderer/index.ts`
- [Session storage](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/browser/chat-session-store-impl.ts): `packages/ai-chat/src/browser/chat-session-store-impl.ts`

### Models and agents

- [Agent services](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/common/chat-agent-service.ts): `packages/ai-chat/src/common/chat-agent-service.ts`
- [Model registry](https://github.com/eclipse-theia/theia/blob/master/packages/ai-core/src/browser/frontend-language-model-registry.ts): `packages/ai-core/src/browser/frontend-language-model-registry.ts`
- [Anthropic provider](https://github.com/eclipse-theia/theia/blob/master/packages/ai-anthropic/src/node/anthropic-language-model.ts): `packages/ai-anthropic/src/node/anthropic-language-model.ts`
- [Copilot provider](https://github.com/eclipse-theia/theia/blob/master/packages/ai-copilot/src/node/copilot-sdk-language-model.ts): `packages/ai-copilot/src/node/copilot-sdk-language-model.ts`
- [Claude Code agent](https://github.com/eclipse-theia/theia/blob/master/packages/ai-claude-code/src/browser/claude-code-chat-agent.ts): `packages/ai-claude-code/src/browser/claude-code-chat-agent.ts`
- [Inline completion](https://github.com/eclipse-theia/theia/blob/master/packages/ai-code-completion/src/browser/ai-code-inline-completion-provider.ts): `packages/ai-code-completion/src/browser/ai-code-inline-completion-provider.ts`

### IDE integration

- [AI configuration](https://github.com/eclipse-theia/theia/tree/master/packages/ai-core-ui/src/browser/ai-configuration): `packages/ai-core-ui/src/browser/ai-configuration`
- [Plugin storage](https://github.com/eclipse-theia/theia/blob/master/packages/plugin-ext/src/plugin/plugin-storage.ts): `packages/plugin-ext/src/plugin/plugin-storage.ts`

### IDE state

- [Preference storage](https://github.com/eclipse-theia/theia/blob/master/packages/preferences/src/browser/frontend-preference-storage.ts): `packages/preferences/src/browser/frontend-preference-storage.ts`
- [Browser storage](https://github.com/eclipse-theia/theia/blob/master/packages/core/src/browser/storage-service.ts): `packages/core/src/browser/storage-service.ts`
- [Task context](https://github.com/eclipse-theia/theia/blob/master/packages/ai-chat/src/browser/task-context-storage-service.ts): `packages/ai-chat/src/browser/task-context-storage-service.ts`
- [Task context files](https://github.com/eclipse-theia/theia/blob/master/packages/ai-ide/src/browser/task-context-file-storage-service.ts): `packages/ai-ide/src/browser/task-context-file-storage-service.ts`
- [Workspace metadata](https://github.com/eclipse-theia/theia/blob/master/packages/workspace/src/browser/metadata-storage/workspace-metadata-storage-service.ts): `packages/workspace/src/browser/metadata-storage/workspace-metadata-storage-service.ts`
- [User storage](https://github.com/eclipse-theia/theia/blob/master/packages/userstorage/src/browser/user-storage-contribution.ts): `packages/userstorage/src/browser/user-storage-contribution.ts`

### Other components

- **IDE user**

## Connections

- IDE user → Chat input: enters prompt
- Chat input → Frontend chat: submits request
- Frontend chat → Chat service: uses service
- Chat service → Agent services: selects agent
- Agent services → Model registry: resolves model
- Frontend chat → Context variables: collects context
- Frontend chat → Tool requests: requests tools
- Chat interface → Response rendering: renders response
- Frontend chat → Session storage: stores sessions
- Model registry → Anthropic provider: uses provider
- Model registry → Copilot provider: uses provider
- Agent services → Claude Code agent: offers agent
- IDE user → Inline completion: requests completion
- AI configuration → Model registry: configures models
- Task context → Task context files: reads task files
- Preference storage → User storage: uses file storage
- Plugin storage → User storage: persists plugin data
- Workspace metadata → User storage: stores workspace data
