# voideditor/void architecture

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

- Interactive diagram: https://gitdiagram.com/voideditor/void
- Repository: https://github.com/voideditor/void

## Overview

Void is a deprecated VS Code desktop fork centered on AI-assisted coding. Its documented user workflow is to use an AI agent with a chosen model or local host, send messages to providers, and apply AI edits; related capabilities include streamed diffs, background file/buffer synchronization, and checkpoint visualization. The graph combines those README-level product flows with sampled startup, message-conversion, storage, search, and Markdown-preview modules. Several product subsystems are documented but unsampled, so their internal links are intentionally limited.

Main entry points: [`src/vs/workbench/contrib/void`](https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void) (AI agents), [`src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts`](https://github.com/voideditor/void/blob/main/src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts) (Edit-session storage), [`src/vs/workbench/contrib/editSessions/common/editSessionsStorageClient.ts`](https://github.com/voideditor/void/blob/main/src/vs/workbench/contrib/editSessions/common/editSessionsStorageClient.ts) (Sync store client), [`src/vs/workbench/contrib/void/browser/convertToLLMMessageService.ts`](https://github.com/voideditor/void/blob/main/src/vs/workbench/contrib/void/browser/convertToLLMMessageService.ts) (Message conversion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["AI coding"]
  node_ai_agent["AI agents"]
  node_message_conversion["Message conversion"]
  node_ai_providers["AI providers and hosts"]
end

subgraph group_editing["Editing and history"]
  node_edit_code["EditCodeService"]
  node_void_model["VoidModelService"]
  node_code_files["OS files and buffers"]
  node_checkpoints["Checkpoints and changes"]
end

subgraph group_desktop["Desktop runtime"]
  node_desktop_entry["Desktop startup<br/>[main.ts]"]
  node_electron_app["Electron workbench<br/>[main.ts]"]
end

subgraph group_workbench["Workbench services"]
  node_shared_primitives["Common primitives"]
  node_workspace_model["Workspace model<br/>[workspace.ts]"]
  node_storage_api["Storage service<br/>[storage.ts]"]
  node_storage_backend[("Desktop storage<br/>[storageMain.ts]")]
  node_edit_session_storage["Edit-session storage"]
  node_edit_session_client["Sync store client"]
  node_text_search["Text search"]
end

subgraph group_extensions["Editor extensions"]
  node_markdown_engine["Markdown engine<br/>[markdownEngine.ts]"]
  node_markdown_preview["Markdown preview<br/>[previewManager.ts]"]
  node_git_extension["Git integration<br/>[main.ts]"]
end

node_developer(("Developer"))

node_developer -->|"uses agents"| node_ai_agent
node_ai_agent -.->|"prepares messages"| node_message_conversion
node_message_conversion -->|"sends messages"| node_ai_providers
node_ai_providers -.->|"returns responses"| node_developer
node_ai_agent -.->|"requests edits"| node_edit_code
node_edit_code -->|"streams diffs"| node_code_files
node_void_model -->|"syncs buffers"| node_code_files
node_developer -->|"reviews changes"| node_checkpoints
node_desktop_entry -->|"loads main"| node_electron_app
node_edit_session_storage -->|"writes resources"| node_edit_session_client
node_edit_session_storage -->|"reads resources"| node_edit_session_client
node_edit_session_client -->|"extends client"| node_edit_session_storage
node_markdown_engine -.->|"renders preview"| node_markdown_preview

click node_desktop_entry "https://github.com/voideditor/void/blob/main/src/main.ts"
click node_electron_app "https://github.com/voideditor/void/blob/main/src/vs/code/electron-main/main.ts"
click node_ai_agent "https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void"
click node_message_conversion "https://github.com/voideditor/void/blob/main/src/vs/workbench/contrib/void/browser/convertToLLMMessageService.ts"
click node_ai_providers "https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void"
click node_edit_code "https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void"
click node_void_model "https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void"
click node_checkpoints "https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void"
click node_shared_primitives "https://github.com/voideditor/void/tree/main/src/vs/base/common"
click node_workspace_model "https://github.com/voideditor/void/blob/main/src/vs/platform/workspace/common/workspace.ts"
click node_storage_api "https://github.com/voideditor/void/blob/main/src/vs/platform/storage/common/storage.ts"
click node_storage_backend "https://github.com/voideditor/void/blob/main/src/vs/platform/storage/electron-main/storageMain.ts"
click node_edit_session_storage "https://github.com/voideditor/void/blob/main/src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts"
click node_edit_session_client "https://github.com/voideditor/void/blob/main/src/vs/workbench/contrib/editSessions/common/editSessionsStorageClient.ts"
click node_text_search "https://github.com/voideditor/void/blob/main/src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts"
click node_markdown_engine "https://github.com/voideditor/void/blob/main/extensions/markdown-language-features/src/markdownEngine.ts"
click node_markdown_preview "https://github.com/voideditor/void/blob/main/extensions/markdown-language-features/src/preview/previewManager.ts"
click node_git_extension "https://github.com/voideditor/void/blob/main/extensions/git/src/main.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_ai_agent,node_message_conversion,node_ai_providers toneBlue
class node_edit_code,node_void_model,node_code_files,node_checkpoints toneAmber
class node_desktop_entry,node_electron_app toneMint
class node_shared_primitives,node_workspace_model,node_storage_api,node_storage_backend,node_edit_session_storage,node_edit_session_client,node_text_search toneRose
class node_markdown_engine,node_markdown_preview,node_git_extension,node_developer toneIndigo
```

## Components

### AI coding

- [AI agents](https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void): `src/vs/workbench/contrib/void`
- [Message conversion](https://github.com/voideditor/void/blob/main/src/vs/workbench/contrib/void/browser/convertToLLMMessageService.ts): `src/vs/workbench/contrib/void/browser/convertToLLMMessageService.ts`
- [AI providers and hosts](https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void): `src/vs/workbench/contrib/void`

### Editing and history

- [EditCodeService](https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void): `src/vs/workbench/contrib/void`
- [VoidModelService](https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void): `src/vs/workbench/contrib/void`
- **OS files and buffers**
- [Checkpoints and changes](https://github.com/voideditor/void/tree/main/src/vs/workbench/contrib/void): `src/vs/workbench/contrib/void`

### Desktop runtime

- [Desktop startup](https://github.com/voideditor/void/blob/main/src/main.ts): `src/main.ts`
- [Electron workbench](https://github.com/voideditor/void/blob/main/src/vs/code/electron-main/main.ts): `src/vs/code/electron-main/main.ts`

### Workbench services

- [Common primitives](https://github.com/voideditor/void/tree/main/src/vs/base/common): `src/vs/base/common`
- [Workspace model](https://github.com/voideditor/void/blob/main/src/vs/platform/workspace/common/workspace.ts): `src/vs/platform/workspace/common/workspace.ts`
- [Storage service](https://github.com/voideditor/void/blob/main/src/vs/platform/storage/common/storage.ts): `src/vs/platform/storage/common/storage.ts`
- [Desktop storage](https://github.com/voideditor/void/blob/main/src/vs/platform/storage/electron-main/storageMain.ts): `src/vs/platform/storage/electron-main/storageMain.ts`
- [Edit-session storage](https://github.com/voideditor/void/blob/main/src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts): `src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts`
- [Sync store client](https://github.com/voideditor/void/blob/main/src/vs/workbench/contrib/editSessions/common/editSessionsStorageClient.ts): `src/vs/workbench/contrib/editSessions/common/editSessionsStorageClient.ts`
- [Text search](https://github.com/voideditor/void/blob/main/src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts): `src/vs/workbench/services/search/node/ripgrepTextSearchEngine.ts`

### Editor extensions

- [Markdown engine](https://github.com/voideditor/void/blob/main/extensions/markdown-language-features/src/markdownEngine.ts): `extensions/markdown-language-features/src/markdownEngine.ts`
- [Markdown preview](https://github.com/voideditor/void/blob/main/extensions/markdown-language-features/src/preview/previewManager.ts): `extensions/markdown-language-features/src/preview/previewManager.ts`
- [Git integration](https://github.com/voideditor/void/blob/main/extensions/git/src/main.ts): `extensions/git/src/main.ts`

### Other components

- **Developer**

## Connections

- Developer → AI agents: uses agents (evidence: `README.md`)
- AI agents → Message conversion: prepares messages (evidence: `src/vs/workbench/contrib/void/browser/convertToLLMMessageService.ts`)
- Message conversion → AI providers and hosts: sends messages (evidence: `README.md`)
- AI providers and hosts → Developer: returns responses
- AI agents → EditCodeService: requests edits
- EditCodeService → OS files and buffers: streams diffs (evidence: `README.md`)
- VoidModelService → OS files and buffers: syncs buffers (evidence: `README.md`)
- Developer → Checkpoints and changes: reviews changes (evidence: `README.md`)
- Desktop startup → Electron workbench: loads main (evidence: `src/main.ts`)
- Edit-session storage → Sync store client: writes resources (evidence: `src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts`)
- Edit-session storage → Sync store client: reads resources (evidence: `src/vs/workbench/contrib/editSessions/browser/editSessionsStorageService.ts`)
- Sync store client → Edit-session storage: extends client (evidence: `src/vs/workbench/contrib/editSessions/common/editSessionsStorageClient.ts`)
- Markdown engine → Markdown preview: renders preview
