How posit-dev/positron works
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: main.ts Positron IDE · agents Copilot Assistant · previewManager.ts Markdown Preview · drivers Data Connections
Components 22
IDE Workbench
- Positron IDE
src/main.ts - Workbench Core
src/vs/base/common - Authentication
src/vs/workbench/services/authentication/browser/authenticationQueryService.ts - Edit Session Storage
src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts
Authoring And Search
- Markdown Preview
extensions/markdown-language-features/src/preview/previewManager.ts - Markdown Engine
extensions/markdown-language-features/src/markdownEngine.ts - Workspace Search
src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts - Source Control
extensions/git/src/cloneManager.ts
Data Science
- Code Cells
extensions/positron-code-cells/src/codeCellManager.ts - Notebook Ghost Cell
src/vs/workbench/contrib/positronNotebook/browser/contrib/ghostCell/useGhostCellController.ts - Data Connections
extensions/positron-connections/src/drivers - Database Drivers
extensions/positron-data-driver-sqlite/src/sqliteDataExplorerRpcHandler.ts - Python Runtime
extensions/positron-python/src/client/positron/manager.ts - R Runtime
extensions/positron-r/src/runtime-manager.ts
Assistant And Services
- Copilot Assistant
extensions/copilot/src/extension/agents - Chat Sessions
extensions/copilot/src/extension/chatSessions/vscode-node/chatSessions.ts - Code Ingestion
extensions/copilot/src/platform/workspaceChunkSearch/node/codeSearch/externalIngestClient.ts - GitHub Services
src/vs/platform/github/common/githubQueryServiceImpl.ts
Runtime And Remote
- Agent Host Manager
src/vs/server/node/serverAgentHostManager.ts - Remote Tunnels
cli/src/tunnels - Desktop Agent CLI
cli/src/commands/agent.rs
Other components
- IDE User
Connections 21
- IDE User → Positron IDE: uses
README.md - Positron IDE → Workbench Core: built on
README.md - IDE User → Markdown Preview: previews documents
- Markdown Preview → Markdown Engine: renders with
extensions/markdown-language-features/src/preview/previewManager.ts - IDE User → Workspace Search: searches workspace
- IDE User → Source Control: uses source control
README.md - IDE User → Code Cells: authors code
README.md - IDE User → Notebook Ghost Cell: authors notebooks
- IDE User → Data Connections: explores data
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
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