How copilotkit/opendots works
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: platform.ts Agent platform · api.ts API client · app.ts HTTP application · Chat.tsx Dot chat
Components 27
Workspace UI
- Workspace shell
src/client/App.tsx - Dot chat
src/client/Chat.tsx - Voice calls
src/client/CallView.tsx - Spaces and pages
src/client/SpaceWorkspace.tsx - Page review
src/client/PageReviewCard.tsx - Computer panel
src/client/ComputerPanel.tsx - Connection settings
src/client/ConnectionsSection.tsx - API client
src/client/api.ts
Agent Runtime
- HTTP application
src/server/app.ts - Agent platform
src/server/platform.ts - Specialist agent
src/server/dot-agent.ts - Voice service
src/server/voice.ts
Workspace Services
- Page routes
src/server/page-routes.ts - Page service
src/server/page-service.ts - Page records
src/server/pages.ts - Workspace state
src/server/workspace.ts - Computer service
src/server/computer-service.ts - Connection routes
src/server/connection-routes.ts - Connection service
src/server/connections.ts - Scheduled research
src/server/research.ts
External Integrations
- Intelligence / Threads
- Model provider
- OpenBot computer
- MCP servers
- Realtime speech
- Slack
Other components
- Workspace owner
Connections 32
- Workspace owner → Workspace shell: uses
README.md - Workspace shell → Dot chat: renders
src/client/App.tsx - Workspace shell → Spaces and pages: opens
src/client/App.tsx - Dot chat → API client: requests
src/client/Chat.tsx - Spaces and pages → API client: requests
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
src/client/Chat.tsx - Dot chat → Voice calls: opens call
src/client/Chat.tsx - Voice calls → Voice service: uses voice
- API client → HTTP application: sends API requests
src/client/api.ts - HTTP application → Agent platform: routes workspace requests
src/server/app.ts - HTTP application → Computer service: mounts computer routes
src/server/app.ts - HTTP application → Connection routes: mounts connection routes
src/server/app.ts - Agent platform → Specialist agent: creates agents
src/server/platform.ts - Agent platform → Intelligence / Threads: uses Threads runtime
README.md - Specialist agent → Model provider: runs model work
README.md - Agent platform → Computer service: constructs
src/server/platform.ts - Agent platform → Connection service: constructs
src/server/platform.ts - Agent platform → Page service: constructs
src/server/platform.ts - Page routes → Page records: reads and writes
src/server/page-routes.ts - Page service → Workspace state: uses workspace
- Workspace state → Page records: owns pages
src/server/workspace.ts - Connection routes → Connection service: manages connections
src/server/connection-routes.ts - Computer service → OpenBot computer: controls computers
README.md - Connection service → MCP servers: connects tools
README.md - Voice service → Realtime speech: bridges calls
README.md - Realtime speech → Specialist agent: bridges compute work
README.md - Agent platform → Slack: starts channel integration
README.md - Slack → Specialist agent: dispatches mentions
README.md - HTTP application → Scheduled research: serves task operations
src/server/app.ts