# zed-industries/zed architecture

> Architecture diagram of the GitHub repository zed-industries/zed, 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/zed-industries/zed
- Repository: https://github.com/zed-industries/zed

## Overview

Zed is a high-performance, multiplayer code editor. The main user workflow is opening a project, editing and navigating code in a workspace, and optionally collaborating or using AI assistance; debugging and extension-backed integrations are important parallel capabilities. The tree identifies these subsystems, but most implementation excerpts are absent, so the graph keeps cross-module wiring sparse. The sampled project connection manager uses the client for remote-project reconnection, and the sampled workspace history manager reads and updates persisted workspace history.

Main entry points: [`crates/agent/src/agent.rs`](https://github.com/zed-industries/zed/blob/main/crates/agent/src/agent.rs) (Agent runtime), [`crates/zed/src/main.rs`](https://github.com/zed-industries/zed/blob/main/crates/zed/src/main.rs) (Zed startup), [`crates/workspace/src/history_manager.rs`](https://github.com/zed-industries/zed/blob/main/crates/workspace/src/history_manager.rs) (Workspace), [`crates/project/src/connection_manager.rs`](https://github.com/zed-industries/zed/blob/main/crates/project/src/connection_manager.rs) (Project model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and editing"]
  node_zed["Zed startup<br/>[main.rs]"]
  node_gpui["UI runtime<br/>[app.rs]"]
  node_editor["Code editor<br/>[editor.rs]"]
  node_workspace["Workspace<br/>[history_manager.rs]"]
  node_project["Project model"]
end

subgraph group_collab["Multiplayer collaboration"]
  node_collab_ui["Collaboration UI<br/>[collab_ui.rs]"]
  node_collab_server["Collaboration service<br/>[lib.rs]"]
  node_channel["Channels<br/>[channel.rs]"]
  node_client["Client<br/>[client.rs]"]
end

subgraph group_ai["AI assistance"]
  node_agent_ui["AI assistant UI<br/>[agent_ui.rs]"]
  node_agent["Agent runtime<br/>[agent.rs]"]
  node_agent_tools["Agent tools<br/>[tools.rs]"]
  node_agent_settings["Agent settings<br/>[agent_settings.rs]"]
  node_cloud_llm["Cloud model client"]
end

subgraph group_integrations["Developer integrations"]
  node_debugger_ui["Debugger UI<br/>[debugger_ui.rs]"]
  node_dap["Debug adapter protocol<br/>[dap.rs]"]
  node_extensions["Extensions<br/>[extension.rs]"]
  node_context_server["Context servers<br/>[context_server.rs]"]
end

subgraph group_state["Workspace state"]
  node_history["Workspace history<br/>[history_manager.rs]"]
  node_workspace_db[("Workspace database<br/>[history_manager.rs]")]
end

node_user(("Developer"))
node_model_service(("Model service"))

node_user -->|"launches"| node_zed
node_zed -->|"runs UI"| node_gpui
node_user -->|"edits code"| node_editor
node_user -->|"opens project"| node_workspace
node_workspace -->|"manages"| node_project
node_history -->|"reads and updates"| node_workspace_db
node_project -->|"requests reconnection"| node_client
node_user -->|"collaborates"| node_collab_ui
node_user -->|"requests assistance"| node_agent_ui
node_agent_ui -->|"interacts with"| node_agent
node_agent -->|"dispatches tools"| node_agent_tools
node_agent -.->|"requests models"| node_cloud_llm
node_cloud_llm -.->|"sends requests"| node_model_service
node_user -->|"debugs"| node_debugger_ui
node_debugger_ui -->|"uses protocol"| node_dap
node_user -->|"uses extensions"| node_extensions
node_agent -.->|"integrates context"| node_context_server

click node_zed "https://github.com/zed-industries/zed/blob/main/crates/zed/src/main.rs"
click node_gpui "https://github.com/zed-industries/zed/blob/main/crates/gpui/src/app.rs"
click node_editor "https://github.com/zed-industries/zed/blob/main/crates/editor/src/editor.rs"
click node_workspace "https://github.com/zed-industries/zed/blob/main/crates/workspace/src/history_manager.rs"
click node_project "https://github.com/zed-industries/zed/blob/main/crates/project/src/connection_manager.rs"
click node_history "https://github.com/zed-industries/zed/blob/main/crates/workspace/src/history_manager.rs"
click node_workspace_db "https://github.com/zed-industries/zed/blob/main/crates/workspace/src/history_manager.rs"
click node_collab_ui "https://github.com/zed-industries/zed/blob/main/crates/collab_ui/src/collab_ui.rs"
click node_collab_server "https://github.com/zed-industries/zed/blob/main/crates/collab/src/lib.rs"
click node_channel "https://github.com/zed-industries/zed/blob/main/crates/channel/src/channel.rs"
click node_client "https://github.com/zed-industries/zed/blob/main/crates/client/src/client.rs"
click node_agent_ui "https://github.com/zed-industries/zed/blob/main/crates/agent_ui/src/agent_ui.rs"
click node_agent "https://github.com/zed-industries/zed/blob/main/crates/agent/src/agent.rs"
click node_agent_tools "https://github.com/zed-industries/zed/blob/main/crates/agent/src/tools.rs"
click node_agent_settings "https://github.com/zed-industries/zed/blob/main/crates/agent_settings/src/agent_settings.rs"
click node_cloud_llm "https://github.com/zed-industries/zed/blob/main/crates/cloud_llm_client/src/cloud_llm_client.rs"
click node_debugger_ui "https://github.com/zed-industries/zed/blob/main/crates/debugger_ui/src/debugger_ui.rs"
click node_dap "https://github.com/zed-industries/zed/blob/main/crates/dap/src/dap.rs"
click node_extensions "https://github.com/zed-industries/zed/blob/main/crates/extension/src/extension.rs"
click node_context_server "https://github.com/zed-industries/zed/blob/main/crates/context_server/src/context_server.rs"

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_zed,node_gpui,node_editor,node_workspace,node_project toneBlue
class node_collab_ui,node_collab_server,node_channel,node_client toneAmber
class node_agent_ui,node_agent,node_agent_tools,node_agent_settings,node_cloud_llm toneMint
class node_debugger_ui,node_dap,node_extensions,node_context_server toneRose
class node_history,node_workspace_db,node_user,node_model_service toneIndigo
```

## Components

### Application and editing

- [Zed startup](https://github.com/zed-industries/zed/blob/main/crates/zed/src/main.rs): `crates/zed/src/main.rs`
- [UI runtime](https://github.com/zed-industries/zed/blob/main/crates/gpui/src/app.rs): `crates/gpui/src/app.rs`
- [Code editor](https://github.com/zed-industries/zed/blob/main/crates/editor/src/editor.rs): `crates/editor/src/editor.rs`
- [Workspace](https://github.com/zed-industries/zed/blob/main/crates/workspace/src/history_manager.rs): `crates/workspace/src/history_manager.rs`
- [Project model](https://github.com/zed-industries/zed/blob/main/crates/project/src/connection_manager.rs): `crates/project/src/connection_manager.rs`

### Multiplayer collaboration

- [Collaboration UI](https://github.com/zed-industries/zed/blob/main/crates/collab_ui/src/collab_ui.rs): `crates/collab_ui/src/collab_ui.rs`
- [Collaboration service](https://github.com/zed-industries/zed/blob/main/crates/collab/src/lib.rs): `crates/collab/src/lib.rs`
- [Channels](https://github.com/zed-industries/zed/blob/main/crates/channel/src/channel.rs): `crates/channel/src/channel.rs`
- [Client](https://github.com/zed-industries/zed/blob/main/crates/client/src/client.rs): `crates/client/src/client.rs`

### AI assistance

- [AI assistant UI](https://github.com/zed-industries/zed/blob/main/crates/agent_ui/src/agent_ui.rs): `crates/agent_ui/src/agent_ui.rs`
- [Agent runtime](https://github.com/zed-industries/zed/blob/main/crates/agent/src/agent.rs): `crates/agent/src/agent.rs`
- [Agent tools](https://github.com/zed-industries/zed/blob/main/crates/agent/src/tools.rs): `crates/agent/src/tools.rs`
- [Agent settings](https://github.com/zed-industries/zed/blob/main/crates/agent_settings/src/agent_settings.rs): `crates/agent_settings/src/agent_settings.rs`
- [Cloud model client](https://github.com/zed-industries/zed/blob/main/crates/cloud_llm_client/src/cloud_llm_client.rs): `crates/cloud_llm_client/src/cloud_llm_client.rs`

### Developer integrations

- [Debugger UI](https://github.com/zed-industries/zed/blob/main/crates/debugger_ui/src/debugger_ui.rs): `crates/debugger_ui/src/debugger_ui.rs`
- [Debug adapter protocol](https://github.com/zed-industries/zed/blob/main/crates/dap/src/dap.rs): `crates/dap/src/dap.rs`
- [Extensions](https://github.com/zed-industries/zed/blob/main/crates/extension/src/extension.rs): `crates/extension/src/extension.rs`
- [Context servers](https://github.com/zed-industries/zed/blob/main/crates/context_server/src/context_server.rs): `crates/context_server/src/context_server.rs`

### Workspace state

- [Workspace history](https://github.com/zed-industries/zed/blob/main/crates/workspace/src/history_manager.rs): `crates/workspace/src/history_manager.rs`
- [Workspace database](https://github.com/zed-industries/zed/blob/main/crates/workspace/src/history_manager.rs): `crates/workspace/src/history_manager.rs`

### Other components

- **Developer**
- **Model service**

## Connections

- Developer → Zed startup: launches
- Zed startup → UI runtime: runs UI
- Developer → Code editor: edits code
- Developer → Workspace: opens project
- Workspace → Project model: manages
- Workspace history → Workspace database: reads and updates
- Project model → Client: requests reconnection
- Developer → Collaboration UI: collaborates
- Developer → AI assistant UI: requests assistance
- AI assistant UI → Agent runtime: interacts with
- Agent runtime → Agent tools: dispatches tools
- Agent runtime → Cloud model client: requests models
- Cloud model client → Model service: sends requests
- Developer → Debugger UI: debugs
- Debugger UI → Debug adapter protocol: uses protocol
- Developer → Extensions: uses extensions
- Agent runtime → Context servers: integrates context
