# posit-dev/positron architecture

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

- Interactive diagram: https://gitdiagram.com/posit-dev/positron
- Repository: https://github.com/posit-dev/positron

## Overview

Positron is a data-science IDE built on Code OSS. Its principal workflow is authoring code and exploring data in a polyglot workspace, supported by language runtimes, data connections, search, and extensible IDE services; reproducible authoring and publishing are additional product goals. The README documents these capabilities at a high level, while the sampled sources show selected implementations such as Markdown previews, text search, authentication, and agent-host management. Links between unsampled subsystems are therefore omitted rather than inferred.

Main entry points: [`src/main.ts`](https://github.com/posit-dev/positron/blob/main/src/main.ts) (Positron IDE), [`extensions/copilot/src/extension/agents`](https://github.com/posit-dev/positron/tree/main/extensions/copilot/src/extension/agents) (Copilot Assistant), [`extensions/markdown-language-features/src/preview/previewManager.ts`](https://github.com/posit-dev/positron/blob/main/extensions/markdown-language-features/src/preview/previewManager.ts) (Markdown Preview), [`extensions/positron-connections/src/drivers`](https://github.com/posit-dev/positron/tree/main/extensions/positron-connections/src/drivers) (Data Connections)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workbench["IDE Workbench"]
  node_positron["Positron IDE<br/>[main.ts]"]
  node_core["Workbench Core"]
  node_auth["Authentication"]
  node_edit_sessions[("Edit Session Storage")]
end

subgraph group_authoring["Authoring And Search"]
  node_markdown["Markdown Preview<br/>[previewManager.ts]"]
  node_markdown_engine["Markdown Engine<br/>[markdownEngine.ts]"]
  node_search["Workspace Search"]
  node_git["Source Control<br/>[cloneManager.ts]"]
end

subgraph group_data["Data Science"]
  node_code_cells["Code Cells<br/>[codeCellManager.ts]"]
  node_notebook["Notebook Ghost Cell"]
  node_connections["Data Connections"]
  node_drivers["Database Drivers"]
  node_python["Python Runtime<br/>[manager.ts]"]
  node_r["R Runtime<br/>[runtime-manager.ts]"]
end

subgraph group_assist["Assistant And Services"]
  node_copilot["Copilot Assistant"]
  node_copilot_sessions["Chat Sessions<br/>[chatSessions.ts]"]
  node_external_ingest["Code Ingestion"]
  node_github["GitHub Services"]
end

subgraph group_runtime["Runtime And Remote"]
  node_agent_host["Agent Host Manager"]
  node_tunnels["Remote Tunnels"]
  node_desktop_agents["Desktop Agent CLI<br/>[agent.rs]"]
end

node_user(("IDE User"))

node_user -->|"uses"| node_positron
node_positron -->|"built on"| node_core
node_user -.->|"previews documents"| node_markdown
node_markdown -->|"renders with"| node_markdown_engine
node_user -.->|"searches workspace"| node_search
node_user -->|"uses source control"| node_git
node_user -->|"authors code"| node_code_cells
node_user -.->|"authors notebooks"| node_notebook
node_user -->|"explores data"| node_connections
node_connections -.->|"uses drivers"| node_drivers
node_user -.->|"uses runtime"| node_python
node_user -.->|"uses runtime"| node_r
node_user -.->|"requests assistance"| node_copilot
node_copilot -.->|"manages sessions"| node_copilot_sessions
node_copilot -.->|"ingests code"| node_external_ingest
node_external_ingest -->|"uses GitHub API"| node_github
node_positron -.->|"provides authentication"| node_auth
node_positron -.->|"stores edit sessions"| node_edit_sessions
node_positron -.->|"hosts agents"| node_agent_host
node_agent_host -.->|"remote access"| node_tunnels
node_user -.->|"manages agents"| node_desktop_agents

click node_positron "https://github.com/posit-dev/positron/blob/main/src/main.ts"
click node_core "https://github.com/posit-dev/positron/tree/main/src/vs/base/common"
click node_auth "https://github.com/posit-dev/positron/blob/main/src/vs/workbench/services/authentication/browser/authenticationQueryService.ts"
click node_markdown "https://github.com/posit-dev/positron/blob/main/extensions/markdown-language-features/src/preview/previewManager.ts"
click node_markdown_engine "https://github.com/posit-dev/positron/blob/main/extensions/markdown-language-features/src/markdownEngine.ts"
click node_search "https://github.com/posit-dev/positron/blob/main/src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts"
click node_git "https://github.com/posit-dev/positron/blob/main/extensions/git/src/cloneManager.ts"
click node_code_cells "https://github.com/posit-dev/positron/blob/main/extensions/positron-code-cells/src/codeCellManager.ts"
click node_notebook "https://github.com/posit-dev/positron/blob/main/src/vs/workbench/contrib/positronNotebook/browser/contrib/ghostCell/useGhostCellController.ts"
click node_connections "https://github.com/posit-dev/positron/tree/main/extensions/positron-connections/src/drivers"
click node_drivers "https://github.com/posit-dev/positron/blob/main/extensions/positron-data-driver-sqlite/src/sqliteDataExplorerRpcHandler.ts"
click node_python "https://github.com/posit-dev/positron/blob/main/extensions/positron-python/src/client/positron/manager.ts"
click node_r "https://github.com/posit-dev/positron/blob/main/extensions/positron-r/src/runtime-manager.ts"
click node_copilot "https://github.com/posit-dev/positron/tree/main/extensions/copilot/src/extension/agents"
click node_copilot_sessions "https://github.com/posit-dev/positron/blob/main/extensions/copilot/src/extension/chatSessions/vscode-node/chatSessions.ts"
click node_external_ingest "https://github.com/posit-dev/positron/blob/main/extensions/copilot/src/platform/workspaceChunkSearch/node/codeSearch/externalIngestClient.ts"
click node_github "https://github.com/posit-dev/positron/blob/main/src/vs/platform/github/common/githubQueryServiceImpl.ts"
click node_agent_host "https://github.com/posit-dev/positron/blob/main/src/vs/server/node/serverAgentHostManager.ts"
click node_tunnels "https://github.com/posit-dev/positron/tree/main/cli/src/tunnels"
click node_desktop_agents "https://github.com/posit-dev/positron/blob/main/cli/src/commands/agent.rs"
click node_edit_sessions "https://github.com/posit-dev/positron/blob/main/src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.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_positron,node_core,node_auth,node_edit_sessions,node_user toneBlue
class node_markdown,node_markdown_engine,node_search,node_git toneAmber
class node_code_cells,node_notebook,node_connections,node_drivers,node_python,node_r toneMint
class node_copilot,node_copilot_sessions,node_external_ingest,node_github toneRose
class node_agent_host,node_tunnels,node_desktop_agents toneIndigo
```

## Components

### IDE Workbench

- [Positron IDE](https://github.com/posit-dev/positron/blob/main/src/main.ts): `src/main.ts`
- [Workbench Core](https://github.com/posit-dev/positron/tree/main/src/vs/base/common): `src/vs/base/common`
- [Authentication](https://github.com/posit-dev/positron/blob/main/src/vs/workbench/services/authentication/browser/authenticationQueryService.ts): `src/vs/workbench/services/authentication/browser/authenticationQueryService.ts`
- [Edit Session Storage](https://github.com/posit-dev/positron/blob/main/src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts): `src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts`

### Authoring And Search

- [Markdown Preview](https://github.com/posit-dev/positron/blob/main/extensions/markdown-language-features/src/preview/previewManager.ts): `extensions/markdown-language-features/src/preview/previewManager.ts`
- [Markdown Engine](https://github.com/posit-dev/positron/blob/main/extensions/markdown-language-features/src/markdownEngine.ts): `extensions/markdown-language-features/src/markdownEngine.ts`
- [Workspace Search](https://github.com/posit-dev/positron/blob/main/src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts): `src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts`
- [Source Control](https://github.com/posit-dev/positron/blob/main/extensions/git/src/cloneManager.ts): `extensions/git/src/cloneManager.ts`

### Data Science

- [Code Cells](https://github.com/posit-dev/positron/blob/main/extensions/positron-code-cells/src/codeCellManager.ts): `extensions/positron-code-cells/src/codeCellManager.ts`
- [Notebook Ghost Cell](https://github.com/posit-dev/positron/blob/main/src/vs/workbench/contrib/positronNotebook/browser/contrib/ghostCell/useGhostCellController.ts): `src/vs/workbench/contrib/positronNotebook/browser/contrib/ghostCell/useGhostCellController.ts`
- [Data Connections](https://github.com/posit-dev/positron/tree/main/extensions/positron-connections/src/drivers): `extensions/positron-connections/src/drivers`
- [Database Drivers](https://github.com/posit-dev/positron/blob/main/extensions/positron-data-driver-sqlite/src/sqliteDataExplorerRpcHandler.ts): `extensions/positron-data-driver-sqlite/src/sqliteDataExplorerRpcHandler.ts`
- [Python Runtime](https://github.com/posit-dev/positron/blob/main/extensions/positron-python/src/client/positron/manager.ts): `extensions/positron-python/src/client/positron/manager.ts`
- [R Runtime](https://github.com/posit-dev/positron/blob/main/extensions/positron-r/src/runtime-manager.ts): `extensions/positron-r/src/runtime-manager.ts`

### Assistant And Services

- [Copilot Assistant](https://github.com/posit-dev/positron/tree/main/extensions/copilot/src/extension/agents): `extensions/copilot/src/extension/agents`
- [Chat Sessions](https://github.com/posit-dev/positron/blob/main/extensions/copilot/src/extension/chatSessions/vscode-node/chatSessions.ts): `extensions/copilot/src/extension/chatSessions/vscode-node/chatSessions.ts`
- [Code Ingestion](https://github.com/posit-dev/positron/blob/main/extensions/copilot/src/platform/workspaceChunkSearch/node/codeSearch/externalIngestClient.ts): `extensions/copilot/src/platform/workspaceChunkSearch/node/codeSearch/externalIngestClient.ts`
- [GitHub Services](https://github.com/posit-dev/positron/blob/main/src/vs/platform/github/common/githubQueryServiceImpl.ts): `src/vs/platform/github/common/githubQueryServiceImpl.ts`

### Runtime And Remote

- [Agent Host Manager](https://github.com/posit-dev/positron/blob/main/src/vs/server/node/serverAgentHostManager.ts): `src/vs/server/node/serverAgentHostManager.ts`
- [Remote Tunnels](https://github.com/posit-dev/positron/tree/main/cli/src/tunnels): `cli/src/tunnels`
- [Desktop Agent CLI](https://github.com/posit-dev/positron/blob/main/cli/src/commands/agent.rs): `cli/src/commands/agent.rs`

### Other components

- **IDE User**

## Connections

- IDE User → Positron IDE: uses (evidence: `README.md`)
- Positron IDE → Workbench Core: built on (evidence: `README.md`)
- IDE User → Markdown Preview: previews documents
- Markdown Preview → Markdown Engine: renders with (evidence: `extensions/markdown-language-features/src/preview/previewManager.ts`)
- IDE User → Workspace Search: searches workspace
- IDE User → Source Control: uses source control (evidence: `README.md`)
- IDE User → Code Cells: authors code (evidence: `README.md`)
- IDE User → Notebook Ghost Cell: authors notebooks
- IDE User → Data Connections: explores data (evidence: `README.md`)
- Data Connections → Database Drivers: uses drivers
- IDE User → Python Runtime: uses runtime
- IDE User → R Runtime: uses runtime
- IDE User → Copilot Assistant: requests assistance
- Copilot Assistant → Chat Sessions: manages sessions
- Copilot Assistant → Code Ingestion: ingests code
- Code Ingestion → GitHub Services: uses GitHub API (evidence: `extensions/copilot/src/platform/workspaceChunkSearch/node/codeSearch/externalIngestClient.ts`)
- Positron IDE → Authentication: provides authentication
- Positron IDE → Edit Session Storage: stores edit sessions
- Positron IDE → Agent Host Manager: hosts agents
- Agent Host Manager → Remote Tunnels: remote access
- IDE User → Desktop Agent CLI: manages agents
