# copilotkit/opendots architecture

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

- Interactive diagram: https://gitdiagram.com/copilotkit/opendots
- Repository: https://github.com/copilotkit/opendots

## Overview

OpenDots is a self-hosted workspace for persistent specialist agents (“Dots”), combining chat and calls with Spaces, computer control, reviewed page creation, external tool connections, and Slack. The main flow is an owner using the web workspace to converse with a Dot; the runtime routes agent work and tool actions, then returns results or pauses for approval. The README documents several integrations whose detailed wiring is not shown in the sampled source, so those links are cited to the README; unsampled internal details are omitted.

Main entry points: [`src/server/platform.ts`](https://github.com/copilotkit/opendots/blob/main/src/server/platform.ts) (Agent platform), [`src/client/api.ts`](https://github.com/copilotkit/opendots/blob/main/src/client/api.ts) (API client), [`src/server/app.ts`](https://github.com/copilotkit/opendots/blob/main/src/server/app.ts) (HTTP application), [`src/client/Chat.tsx`](https://github.com/copilotkit/opendots/blob/main/src/client/Chat.tsx) (Dot chat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Workspace UI"]
  node_app_ui["Workspace shell<br/>[App.tsx]"]
  node_chat_ui["Dot chat<br/>[Chat.tsx]"]
  node_call_ui["Voice calls<br/>[CallView.tsx]"]
  node_space_ui["Spaces and pages<br/>[SpaceWorkspace.tsx]"]
  node_review_ui["Page review<br/>[PageReviewCard.tsx]"]
  node_computer_ui["Computer panel<br/>[ComputerPanel.tsx]"]
  node_connections_ui["Connection settings"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_runtime["Agent Runtime"]
  node_http_api["HTTP application<br/>[app.ts]"]
  node_platform["Agent platform<br/>[platform.ts]"]
  node_dot_agent["Specialist agent<br/>[dot-agent.ts]"]
  node_voice_service["Voice service<br/>[voice.ts]"]
end

subgraph group_domain["Workspace Services"]
  node_page_routes["Page routes<br/>[page-routes.ts]"]
  node_page_service["Page service<br/>[page-service.ts]"]
  node_page_store[("Page records<br/>[pages.ts]")]
  node_workspace_store[("Workspace state<br/>[workspace.ts]")]
  node_computer_service["Computer service"]
  node_connection_routes["Connection routes"]
  node_connection_service["Connection service<br/>[connections.ts]"]
  node_research["Scheduled research<br/>[research.ts]"]
end

subgraph group_integrations["External Integrations"]
  node_intelligence["Intelligence / Threads"]
  node_model_provider["Model provider"]
  node_computer_backend["OpenBot computer"]
  node_mcp["MCP servers"]
  node_speech["Realtime speech"]
  node_slack["Slack"]
end

node_owner(("Workspace owner"))

node_owner -->|"uses"| node_app_ui
node_app_ui -->|"renders"| node_chat_ui
node_app_ui -->|"opens"| node_space_ui
node_chat_ui -->|"requests"| node_api_client
node_space_ui -->|"requests"| node_api_client
node_review_ui -->|"submits decision"| node_api_client
node_computer_ui -.->|"controls computer"| node_api_client
node_connections_ui -.->|"manages tools"| node_api_client
node_chat_ui -->|"renders review"| node_review_ui
node_chat_ui -->|"opens call"| node_call_ui
node_call_ui -.->|"uses voice"| node_voice_service
node_api_client -->|"sends API requests"| node_http_api
node_http_api -->|"routes workspace requests"| node_platform
node_http_api -->|"mounts computer routes"| node_computer_service
node_http_api -->|"mounts connection routes"| node_connection_routes
node_platform -->|"creates agents"| node_dot_agent
node_platform -->|"uses Threads runtime"| node_intelligence
node_dot_agent -->|"runs model work"| node_model_provider
node_platform -->|"constructs"| node_computer_service
node_platform -->|"constructs"| node_connection_service
node_platform -->|"constructs"| node_page_service
node_page_routes -->|"reads and writes"| node_page_store
node_page_service -.->|"uses workspace"| node_workspace_store
node_workspace_store -->|"owns pages"| node_page_store
node_connection_routes -->|"manages connections"| node_connection_service
node_computer_service -->|"controls computers"| node_computer_backend
node_connection_service -->|"connects tools"| node_mcp
node_voice_service -->|"bridges calls"| node_speech
node_speech -->|"bridges compute work"| node_dot_agent
node_platform -->|"starts channel integration"| node_slack
node_slack -->|"dispatches mentions"| node_dot_agent
node_http_api -->|"serves task operations"| node_research

click node_app_ui "https://github.com/copilotkit/opendots/blob/main/src/client/App.tsx"
click node_chat_ui "https://github.com/copilotkit/opendots/blob/main/src/client/Chat.tsx"
click node_call_ui "https://github.com/copilotkit/opendots/blob/main/src/client/CallView.tsx"
click node_space_ui "https://github.com/copilotkit/opendots/blob/main/src/client/SpaceWorkspace.tsx"
click node_review_ui "https://github.com/copilotkit/opendots/blob/main/src/client/PageReviewCard.tsx"
click node_computer_ui "https://github.com/copilotkit/opendots/blob/main/src/client/ComputerPanel.tsx"
click node_connections_ui "https://github.com/copilotkit/opendots/blob/main/src/client/ConnectionsSection.tsx"
click node_api_client "https://github.com/copilotkit/opendots/blob/main/src/client/api.ts"
click node_http_api "https://github.com/copilotkit/opendots/blob/main/src/server/app.ts"
click node_platform "https://github.com/copilotkit/opendots/blob/main/src/server/platform.ts"
click node_dot_agent "https://github.com/copilotkit/opendots/blob/main/src/server/dot-agent.ts"
click node_voice_service "https://github.com/copilotkit/opendots/blob/main/src/server/voice.ts"
click node_page_routes "https://github.com/copilotkit/opendots/blob/main/src/server/page-routes.ts"
click node_page_service "https://github.com/copilotkit/opendots/blob/main/src/server/page-service.ts"
click node_page_store "https://github.com/copilotkit/opendots/blob/main/src/server/pages.ts"
click node_workspace_store "https://github.com/copilotkit/opendots/blob/main/src/server/workspace.ts"
click node_computer_service "https://github.com/copilotkit/opendots/blob/main/src/server/computer-service.ts"
click node_connection_routes "https://github.com/copilotkit/opendots/blob/main/src/server/connection-routes.ts"
click node_connection_service "https://github.com/copilotkit/opendots/blob/main/src/server/connections.ts"
click node_research "https://github.com/copilotkit/opendots/blob/main/src/server/research.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_app_ui,node_chat_ui,node_call_ui,node_space_ui,node_review_ui,node_computer_ui,node_connections_ui,node_api_client toneBlue
class node_http_api,node_platform,node_dot_agent,node_voice_service toneAmber
class node_page_routes,node_page_service,node_page_store,node_workspace_store,node_computer_service,node_connection_routes,node_connection_service,node_research toneMint
class node_intelligence,node_model_provider,node_computer_backend,node_mcp,node_speech,node_slack toneRose
class node_owner toneIndigo
```

## Components

### Workspace UI

- [Workspace shell](https://github.com/copilotkit/opendots/blob/main/src/client/App.tsx): `src/client/App.tsx`
- [Dot chat](https://github.com/copilotkit/opendots/blob/main/src/client/Chat.tsx): `src/client/Chat.tsx`
- [Voice calls](https://github.com/copilotkit/opendots/blob/main/src/client/CallView.tsx): `src/client/CallView.tsx`
- [Spaces and pages](https://github.com/copilotkit/opendots/blob/main/src/client/SpaceWorkspace.tsx): `src/client/SpaceWorkspace.tsx`
- [Page review](https://github.com/copilotkit/opendots/blob/main/src/client/PageReviewCard.tsx): `src/client/PageReviewCard.tsx`
- [Computer panel](https://github.com/copilotkit/opendots/blob/main/src/client/ComputerPanel.tsx): `src/client/ComputerPanel.tsx`
- [Connection settings](https://github.com/copilotkit/opendots/blob/main/src/client/ConnectionsSection.tsx): `src/client/ConnectionsSection.tsx`
- [API client](https://github.com/copilotkit/opendots/blob/main/src/client/api.ts): `src/client/api.ts`

### Agent Runtime

- [HTTP application](https://github.com/copilotkit/opendots/blob/main/src/server/app.ts): `src/server/app.ts`
- [Agent platform](https://github.com/copilotkit/opendots/blob/main/src/server/platform.ts): `src/server/platform.ts`
- [Specialist agent](https://github.com/copilotkit/opendots/blob/main/src/server/dot-agent.ts): `src/server/dot-agent.ts`
- [Voice service](https://github.com/copilotkit/opendots/blob/main/src/server/voice.ts): `src/server/voice.ts`

### Workspace Services

- [Page routes](https://github.com/copilotkit/opendots/blob/main/src/server/page-routes.ts): `src/server/page-routes.ts`
- [Page service](https://github.com/copilotkit/opendots/blob/main/src/server/page-service.ts): `src/server/page-service.ts`
- [Page records](https://github.com/copilotkit/opendots/blob/main/src/server/pages.ts): `src/server/pages.ts`
- [Workspace state](https://github.com/copilotkit/opendots/blob/main/src/server/workspace.ts): `src/server/workspace.ts`
- [Computer service](https://github.com/copilotkit/opendots/blob/main/src/server/computer-service.ts): `src/server/computer-service.ts`
- [Connection routes](https://github.com/copilotkit/opendots/blob/main/src/server/connection-routes.ts): `src/server/connection-routes.ts`
- [Connection service](https://github.com/copilotkit/opendots/blob/main/src/server/connections.ts): `src/server/connections.ts`
- [Scheduled research](https://github.com/copilotkit/opendots/blob/main/src/server/research.ts): `src/server/research.ts`

### External Integrations

- **Intelligence / Threads**
- **Model provider**
- **OpenBot computer**
- **MCP servers**
- **Realtime speech**
- **Slack**

### Other components

- **Workspace owner**

## Connections

- Workspace owner → Workspace shell: uses (evidence: `README.md`)
- Workspace shell → Dot chat: renders (evidence: `src/client/App.tsx`)
- Workspace shell → Spaces and pages: opens (evidence: `src/client/App.tsx`)
- Dot chat → API client: requests (evidence: `src/client/Chat.tsx`)
- Spaces and pages → API client: requests (evidence: `src/client/SpaceWorkspace.tsx`)
- Page review → API client: submits decision
- Computer panel → API client: controls computer
- Connection settings → API client: manages tools
- Dot chat → Page review: renders review (evidence: `src/client/Chat.tsx`)
- Dot chat → Voice calls: opens call (evidence: `src/client/Chat.tsx`)
- Voice calls → Voice service: uses voice
- API client → HTTP application: sends API requests (evidence: `src/client/api.ts`)
- HTTP application → Agent platform: routes workspace requests (evidence: `src/server/app.ts`)
- HTTP application → Computer service: mounts computer routes (evidence: `src/server/app.ts`)
- HTTP application → Connection routes: mounts connection routes (evidence: `src/server/app.ts`)
- Agent platform → Specialist agent: creates agents (evidence: `src/server/platform.ts`)
- Agent platform → Intelligence / Threads: uses Threads runtime (evidence: `README.md`)
- Specialist agent → Model provider: runs model work (evidence: `README.md`)
- Agent platform → Computer service: constructs (evidence: `src/server/platform.ts`)
- Agent platform → Connection service: constructs (evidence: `src/server/platform.ts`)
- Agent platform → Page service: constructs (evidence: `src/server/platform.ts`)
- Page routes → Page records: reads and writes (evidence: `src/server/page-routes.ts`)
- Page service → Workspace state: uses workspace
- Workspace state → Page records: owns pages (evidence: `src/server/workspace.ts`)
- Connection routes → Connection service: manages connections (evidence: `src/server/connection-routes.ts`)
- Computer service → OpenBot computer: controls computers (evidence: `README.md`)
- Connection service → MCP servers: connects tools (evidence: `README.md`)
- Voice service → Realtime speech: bridges calls (evidence: `README.md`)
- Realtime speech → Specialist agent: bridges compute work (evidence: `README.md`)
- Agent platform → Slack: starts channel integration (evidence: `README.md`)
- Slack → Specialist agent: dispatches mentions (evidence: `README.md`)
- HTTP application → Scheduled research: serves task operations (evidence: `src/server/app.ts`)
