# OpenBot architecture

OpenBot is a Bun workspace with desktop, browser, and mobile applications, two Cloudflare Workers,
a self-hosted Signal service, and shared packages.

The architecture notes are in one file for each topic:

- [Repository structure](architecture/structure.md)
  - [Workspace map](architecture/structure.md#workspace-map)
  - [Dependency direction](architecture/structure.md#dependency-direction)
  - [State ownership](architecture/structure.md#state-ownership)
  - [Shared UI package](architecture/structure.md#shared-ui-package)
- [Change rules and verification](architecture/change-rules.md)
  - [Effect service execution](architecture/change-rules.md#effect-service-execution)
  - [Change rules](architecture/change-rules.md#change-rules)
  - [Required verification](architecture/change-rules.md#required-verification)
- [Team API compatibility](architecture/team-api.md)
  - [Team API compatibility boundary](architecture/team-api.md#team-api-compatibility-boundary)
- [Browser](architecture/browser.md)
  - [Browser client](architecture/browser.md#browser-client)
  - [Browser tool execution](architecture/browser.md#browser-tool-execution)
  - [Secure browser authentication](architecture/browser.md#secure-browser-authentication)
- [Computer Use and remote desktop](architecture/computer-use.md)
  - [Computer Use](architecture/computer-use.md#computer-use)
  - [Remote desktop permission checks and live tests](architecture/computer-use.md#remote-desktop-permission-checks-and-live-tests)
- [Providers](architecture/providers.md)
  - [Provider CLI updates](architecture/providers.md#provider-cli-updates)
  - [OpenCode and ACP](architecture/providers.md#opencode-and-acp)
- [Agents](architecture/agents.md)
  - [Local scripts API](architecture/agents.md#local-scripts-api)
  - [Routine flows](architecture/agents.md#routine-flows)
  - [Agent communication policy](architecture/agents.md#agent-communication-policy)
  - [Prompt-driven agent profiles](architecture/agents.md#prompt-driven-agent-profiles)
  - [Agent import](architecture/agents.md#agent-import)
  - [Instance transfer](architecture/agents.md#instance-transfer)
  - [Agent templates](architecture/agents.md#agent-templates)
- [Analytics](architecture/analytics.md)
  - [Mobile product analytics](architecture/analytics.md#mobile-product-analytics)
  - [Website analytics](architecture/analytics.md#website-analytics)
  - [Agent usage analytics](architecture/analytics.md#agent-usage-analytics)
- [Servers, storage, and billing](architecture/servers.md)
  - [Storage and files](architecture/servers.md#storage-and-files)
  - [Desktop server notifications](architecture/servers.md#desktop-server-notifications)
  - [Billing](architecture/servers.md#billing)
  - [macOS Host Manager](architecture/servers.md#macos-host-manager)
  - [Hosted servers](architecture/servers.md#hosted-servers)
- [Channels, messaging, and mobile](architecture/channels-and-messaging.md)
  - [iPhone Live Activity updates](architecture/channels-and-messaging.md#iphone-live-activity-updates)
  - [iPhone notifications](architecture/channels-and-messaging.md#iphone-notifications)
  - [Android notifications](architecture/channels-and-messaging.md#android-notifications)
  - [Shared channel chats](architecture/channels-and-messaging.md#shared-channel-chats)
  - [Messaging connections](architecture/channels-and-messaging.md#messaging-connections)
  - [Mobile chat queue](architecture/channels-and-messaging.md#mobile-chat-queue)
- [Skills and plugins](architecture/skills-and-plugins.md)
  - [Skill folders and MCP configuration](architecture/skills-and-plugins.md#skill-folders-and-mcp-configuration)
  - [Local skill library](architecture/skills-and-plugins.md#local-skill-library)
  - [Plugin distribution](architecture/skills-and-plugins.md#plugin-distribution)
- [Integrations and sign-in](architecture/integrations.md)
  - [How a sign-in reaches OpenBot](architecture/integrations.md#how-a-sign-in-reaches-openbot)
  - [Remote sign-in: the callback relay](architecture/integrations.md#remote-sign-in-the-callback-relay)
  - [Add a provider](architecture/integrations.md#add-a-provider)
  - [Add an application](architecture/integrations.md#add-an-application)
  - [Add a connector](architecture/integrations.md#add-a-connector)
  - [Add a Team API capability](architecture/integrations.md#add-a-team-api-capability)