# microsoft/vscode architecture

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

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

## Overview

Code - OSS is the open-source codebase for Visual Studio Code, an extensible editor for the edit-build-debug cycle. The principal workflow is a developer editing and navigating code, searching a workspace, and using lightweight debugging and existing tools; extensions add language support and other capabilities. The map also preserves sampled Markdown preview, GitHub pull-request, authentication, edit-session, and agent-host subsystems. Edges cite README-level capability descriptions or sampled call/import evidence; unsampled implementation details are not inferred.

Main entry points: [`src/main.ts`](https://github.com/microsoft/vscode/blob/main/src/main.ts) (Code Editor), [`src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts`](https://github.com/microsoft/vscode/blob/main/src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts) (Workspace Search), [`extensions/markdown-language-features/src/markdownEngine.ts`](https://github.com/microsoft/vscode/blob/main/extensions/markdown-language-features/src/markdownEngine.ts) (Markdown Engine), [`src/vs/workbench`](https://github.com/microsoft/vscode/tree/main/src/vs/workbench) (Extension Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workbench["Editor Workbench"]
  node_editor["Code Editor<br/>[main.ts]"]
  node_textsearch["Workspace Search"]
  node_debug["Debugging"]
  node_tooling["Tool Integration"]
end

subgraph group_language["Language Features"]
  node_markdown["Markdown Engine<br/>[markdownEngine.ts]"]
  node_preview["Markdown Preview<br/>[previewManager.ts]"]
  node_extensionmodel["Extension Model"]
  node_copilot["Copilot Extension"]
end

subgraph group_collaboration["Collaboration Services"]
  node_prquery["Pull Requests"]
  node_authquery["Authentication Queries"]
  node_editsessions["Edit Sessions"]
end

subgraph group_agents["Agent Hosting"]
  node_agentmanager["Server Agent Manager"]
  node_sessionidentity["Session Identity"]
  node_agentprotocol["Agent Contracts<br/>[agent.ts]"]
  node_sessionstate["Session State<br/>[sessionState.ts]"]
end

subgraph group_foundation["Shared Foundation"]
  node_async["Async Primitives<br/>[async.ts]"]
  node_events["Event Primitives<br/>[event.ts]"]
  node_lifecycle["Lifecycle Utilities<br/>[lifecycle.ts]"]
  node_maps["Map Utilities<br/>[map.ts]"]
  node_platform["Platform Utilities<br/>[platform.ts]"]
  node_resources["Resource Utilities<br/>[resources.ts]"]
  node_strings["String Utilities<br/>[strings.ts]"]
  node_uri["URI Handling<br/>[uri.ts]"]
  node_localization["Localization<br/>[nls.ts]"]
  node_contextkeys["Context Keys<br/>[contextkey.ts]"]
  node_logging["Logging<br/>[log.ts]"]
end

node_developer(("Developer"))

node_developer -->|"edits code"| node_editor
node_developer -->|"searches workspace"| node_textsearch
node_developer -->|"debugs code"| node_debug
node_editor -->|"uses tools"| node_tooling
node_editor -->|"extends through"| node_extensionmodel
node_extensionmodel -->|"provides language support"| node_markdown
node_markdown -->|"renders previews"| node_preview
node_textsearch -.->|"reports matches"| node_editor
node_agentmanager -->|"uses contracts"| node_agentprotocol
node_authquery -.->|"logs queries"| node_logging
node_prquery -.->|"logs requests"| node_logging
node_sessionidentity -->|"uses state"| node_sessionstate

click node_editor "https://github.com/microsoft/vscode/blob/main/src/main.ts"
click node_textsearch "https://github.com/microsoft/vscode/blob/main/src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts"
click node_debug "https://github.com/microsoft/vscode/tree/main/src/vs/workbench"
click node_tooling "https://github.com/microsoft/vscode/tree/main/src/vs/workbench"
click node_markdown "https://github.com/microsoft/vscode/blob/main/extensions/markdown-language-features/src/markdownEngine.ts"
click node_preview "https://github.com/microsoft/vscode/blob/main/extensions/markdown-language-features/src/preview/previewManager.ts"
click node_extensionmodel "https://github.com/microsoft/vscode/tree/main/src/vs/workbench"
click node_copilot "https://github.com/microsoft/vscode/tree/main/extensions/copilot/src/extension"
click node_prquery "https://github.com/microsoft/vscode/blob/main/src/vs/platform/github/common/pullRequestQueryService.ts"
click node_authquery "https://github.com/microsoft/vscode/blob/main/src/vs/workbench/services/authentication/browser/authenticationQueryService.ts"
click node_editsessions "https://github.com/microsoft/vscode/blob/main/src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts"
click node_agentmanager "https://github.com/microsoft/vscode/blob/main/src/vs/server/node/serverAgentHostManager.ts"
click node_sessionidentity "https://github.com/microsoft/vscode/blob/main/src/vs/platform/agentHost/node/sessionStorageIdentity.ts"
click node_async "https://github.com/microsoft/vscode/blob/main/src/vs/base/common/async.ts"
click node_events "https://github.com/microsoft/vscode/blob/main/src/vs/base/common/event.ts"
click node_lifecycle "https://github.com/microsoft/vscode/blob/main/src/vs/base/common/lifecycle.ts"
click node_maps "https://github.com/microsoft/vscode/blob/main/src/vs/base/common/map.ts"
click node_platform "https://github.com/microsoft/vscode/blob/main/src/vs/base/common/platform.ts"
click node_resources "https://github.com/microsoft/vscode/blob/main/src/vs/base/common/resources.ts"
click node_strings "https://github.com/microsoft/vscode/blob/main/src/vs/base/common/strings.ts"
click node_uri "https://github.com/microsoft/vscode/blob/main/src/vs/base/common/uri.ts"
click node_localization "https://github.com/microsoft/vscode/blob/main/src/vs/nls.ts"
click node_contextkeys "https://github.com/microsoft/vscode/blob/main/src/vs/platform/contextkey/common/contextkey.ts"
click node_logging "https://github.com/microsoft/vscode/blob/main/src/vs/platform/log/common/log.ts"
click node_agentprotocol "https://github.com/microsoft/vscode/blob/main/src/vs/platform/agentHost/common/agent.ts"
click node_sessionstate "https://github.com/microsoft/vscode/blob/main/src/vs/platform/agentHost/common/state/sessionState.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_editor,node_textsearch,node_debug,node_tooling toneBlue
class node_markdown,node_preview,node_extensionmodel,node_copilot toneAmber
class node_prquery,node_authquery,node_editsessions toneMint
class node_agentmanager,node_sessionidentity,node_agentprotocol,node_sessionstate toneRose
class node_async,node_events,node_lifecycle,node_maps,node_platform,node_resources,node_strings,node_uri,node_localization,node_contextkeys,node_logging,node_developer toneIndigo
```

## Components

### Editor Workbench

- [Code Editor](https://github.com/microsoft/vscode/blob/main/src/main.ts): `src/main.ts`
- [Workspace Search](https://github.com/microsoft/vscode/blob/main/src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts): `src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts`
- [Debugging](https://github.com/microsoft/vscode/tree/main/src/vs/workbench): `src/vs/workbench`
- [Tool Integration](https://github.com/microsoft/vscode/tree/main/src/vs/workbench): `src/vs/workbench`

### Language Features

- [Markdown Engine](https://github.com/microsoft/vscode/blob/main/extensions/markdown-language-features/src/markdownEngine.ts): `extensions/markdown-language-features/src/markdownEngine.ts`
- [Markdown Preview](https://github.com/microsoft/vscode/blob/main/extensions/markdown-language-features/src/preview/previewManager.ts): `extensions/markdown-language-features/src/preview/previewManager.ts`
- [Extension Model](https://github.com/microsoft/vscode/tree/main/src/vs/workbench): `src/vs/workbench`
- [Copilot Extension](https://github.com/microsoft/vscode/tree/main/extensions/copilot/src/extension): `extensions/copilot/src/extension`

### Collaboration Services

- [Pull Requests](https://github.com/microsoft/vscode/blob/main/src/vs/platform/github/common/pullRequestQueryService.ts): `src/vs/platform/github/common/pullRequestQueryService.ts`
- [Authentication Queries](https://github.com/microsoft/vscode/blob/main/src/vs/workbench/services/authentication/browser/authenticationQueryService.ts): `src/vs/workbench/services/authentication/browser/authenticationQueryService.ts`
- [Edit Sessions](https://github.com/microsoft/vscode/blob/main/src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts): `src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts`

### Agent Hosting

- [Server Agent Manager](https://github.com/microsoft/vscode/blob/main/src/vs/server/node/serverAgentHostManager.ts): `src/vs/server/node/serverAgentHostManager.ts`
- [Session Identity](https://github.com/microsoft/vscode/blob/main/src/vs/platform/agentHost/node/sessionStorageIdentity.ts): `src/vs/platform/agentHost/node/sessionStorageIdentity.ts`
- [Agent Contracts](https://github.com/microsoft/vscode/blob/main/src/vs/platform/agentHost/common/agent.ts): `src/vs/platform/agentHost/common/agent.ts`
- [Session State](https://github.com/microsoft/vscode/blob/main/src/vs/platform/agentHost/common/state/sessionState.ts): `src/vs/platform/agentHost/common/state/sessionState.ts`

### Shared Foundation

- [Async Primitives](https://github.com/microsoft/vscode/blob/main/src/vs/base/common/async.ts): `src/vs/base/common/async.ts`
- [Event Primitives](https://github.com/microsoft/vscode/blob/main/src/vs/base/common/event.ts): `src/vs/base/common/event.ts`
- [Lifecycle Utilities](https://github.com/microsoft/vscode/blob/main/src/vs/base/common/lifecycle.ts): `src/vs/base/common/lifecycle.ts`
- [Map Utilities](https://github.com/microsoft/vscode/blob/main/src/vs/base/common/map.ts): `src/vs/base/common/map.ts`
- [Platform Utilities](https://github.com/microsoft/vscode/blob/main/src/vs/base/common/platform.ts): `src/vs/base/common/platform.ts`
- [Resource Utilities](https://github.com/microsoft/vscode/blob/main/src/vs/base/common/resources.ts): `src/vs/base/common/resources.ts`
- [String Utilities](https://github.com/microsoft/vscode/blob/main/src/vs/base/common/strings.ts): `src/vs/base/common/strings.ts`
- [URI Handling](https://github.com/microsoft/vscode/blob/main/src/vs/base/common/uri.ts): `src/vs/base/common/uri.ts`
- [Localization](https://github.com/microsoft/vscode/blob/main/src/vs/nls.ts): `src/vs/nls.ts`
- [Context Keys](https://github.com/microsoft/vscode/blob/main/src/vs/platform/contextkey/common/contextkey.ts): `src/vs/platform/contextkey/common/contextkey.ts`
- [Logging](https://github.com/microsoft/vscode/blob/main/src/vs/platform/log/common/log.ts): `src/vs/platform/log/common/log.ts`

### Other components

- **Developer**

## Connections

- Developer → Code Editor: edits code (evidence: `README.md`)
- Developer → Workspace Search: searches workspace (evidence: `README.md`)
- Developer → Debugging: debugs code (evidence: `README.md`)
- Code Editor → Tool Integration: uses tools (evidence: `README.md`)
- Code Editor → Extension Model: extends through (evidence: `README.md`)
- Extension Model → Markdown Engine: provides language support (evidence: `README.md`)
- Markdown Engine → Markdown Preview: renders previews (evidence: `extensions/markdown-language-features/src/preview/previewManager.ts`)
- Workspace Search → Code Editor: reports matches
- Server Agent Manager → Agent Contracts: uses contracts (evidence: `src/vs/server/node/serverAgentHostManager.ts`)
- Authentication Queries → Logging: logs queries (evidence: `src/vs/workbench/services/authentication/browser/authenticationQueryService.ts`)
- Pull Requests → Logging: logs requests (evidence: `src/vs/platform/github/common/pullRequestQueryService.ts`)
- Session Identity → Session State: uses state (evidence: `src/vs/platform/agentHost/node/sessionStorageIdentity.ts`)
