How nightly-labs/openbot works
OpenBot is a local-first workspace for persistent AI teammates, delivered as a desktop app with mobile and joined-server access. Its main workflow is creating an agent, running provider-backed conversations in independent workspaces, and coordinating work through queues, shared channels, messaging, and file transfers. The graph also preserves the embedded browser, account services, and hosted/remote access. Most product relationships below come from the README; source excerpts give additional evidence for provider runtime management and storage. Unsampled modules are represented only where the README documents their capabilities.
Main entry points: backend Agent sessions · src Desktop app · agents Agent setup · StorageOverview.tsx Storage surfaces
Components 23
Agent runtime
- Agent setup
src/renderer/src/features/agents - Provider runtimes
src/main/provider-runtime-manager.ts - Agent sessions
src/backend
Workspace features
- Agent workspaces
src/backend/agent-data - Message queues
src/backend - Agent messaging
src/backend/messaging/messaging-service.ts - Shared channels
src/backend - Files and transfers
packages/ui/src/features/files - Embedded browser
src/backend - Storage scanner
src/backend/storage-usage.ts - Storage queries
src/backend/database/storage-usage-queries.ts - Storage surfaces
packages/ui/src/features/files/StorageOverview.tsx
App and access
- Desktop app
src/renderer/src - Mobile app
apps/mobile/src - Self-hosted server
src/backend - Remote API
remote/api/src/app.ts - Remote signaling
remote/api/src/signal-service.ts - Storage IPC
src/main/ipc/storage-handlers.ts
Accounts and services
- Account API
apps/auth-api/src/server/auth-service.ts - D1 auth repository
apps/auth-api/src/server/d1-auth-repository.ts
Shared contracts
- Storage wire contract
packages/contracts/src/ipc-storage.ts
Other components
- User
- AI providers
Connections 25
- User → Desktop app: uses
- User → Mobile app: uses
- User → Self-hosted server: uses
- Desktop app → Agent setup: creates agents
- Agent setup → Provider runtimes: selects runtime
src/main/provider-runtime-manager.ts - Provider runtimes → AI providers: manages CLIs
- Agent sessions → AI providers: runs sessions
- Agent setup → Agent sessions: starts agents
- Agent sessions → Agent workspaces: uses workspace
- Agent sessions → Message queues: processes messages
- Agent sessions → Agent messaging: exchanges messages
- Shared channels → Agent sessions: delegates tasks
- Agent sessions → Files and transfers: transfers files
- Agent sessions → Embedded browser: controls browser
- Desktop app → Remote API: connects remotely
- Remote API → Remote signaling: uses signaling
remote/api/src/app.ts - Desktop app → Account API: signs in
- Account API → D1 auth repository: persists accounts
apps/auth-api/src/server/auth-service.ts - Desktop app → Storage surfaces: views storage
- Storage surfaces → Storage IPC: requests storage
- Storage IPC → Storage scanner: runs scans
src/main/ipc/storage-handlers.ts - Storage scanner → Storage queries: reads chat data
src/backend/storage-usage.ts - Storage IPC → Storage wire contract: validates payloads
src/main/ipc/storage-handlers.ts - Storage surfaces → Storage wire contract: renders usage
packages/ui/src/features/files/StorageOverview.tsx - Mobile app → Self-hosted server: uses server