How yetone/cumora works
Cumora is a cross-platform team chat and work-coordination product where humans and AI agents share conversations, boards, calendars, documents, and email. Users enter through the authenticated React app, which loads team state and sends commands to the server; the server persists changes and delivers realtime updates. Agent work is coordinated and executed either in managed pods or through paired BYOA computers, with runtime actions using the shared CLI protocol. The README documents the main capabilities and infrastructure; sampled source supports selected API, agent-runtime, and storage links, so uncertain internal wiring is omitted.
Main entry points: router.ts HTTP API · client.ts API client · server.ts Runtime API · App.tsx App bootstrap
Components 27
Client apps
- App bootstrap
src/App.tsx - Desktop UI
src/desktop/DesktopApp.tsx - Mobile UI
src/mobile/MobileApp.tsx - API client
src/api/client.ts
Application backend
- HTTP API
server/src/api/router.ts - Realtime gateway
server/src/ws.ts
Team workspace
- Boards and tasks
server/src/api/router.ts - Team calendar
server/src/calendar.ts - Shared documents
server/src/documents/rooms.ts - Shipping workflow
server/src/api/shipping-router.ts - Chat and email
server/src/api/router.ts
Agent platform
- Agent coordination
server/src/agents/routing.ts - Agent scheduler
server/src/agents/scheduler.ts - Agent turns
server/src/agents/turn.ts - Runtime API
server/src/agents/runtime/server.ts - Managed agent pods
server/src/agents/runtime/orchestrator.ts - BYOA daemon
agent-cli/src/cli.ts - Workspace mount
agent-fuse/main.go
Persistence and integrations
- PostgreSQL
server/src/db/pool.ts - Redis
server/src/redis.ts - Realtime outbox
server/src/realtime-outbox.ts - File storage
server/src/storage.ts - Email and CDN gates
workers/email-gate/src/index.ts
Other components
- People
- OpenAI service
- Email service
- Push services
Connections 32
- People → App bootstrap: use app
- App bootstrap → Desktop UI: select shell
- App bootstrap → Mobile UI: select shell
- Desktop UI → API client: issue requests
- Mobile UI → API client: issue requests
- API client → HTTP API: HTTP requests
- HTTP API → API client: return responses
- API client → Realtime gateway: open realtime
- Realtime gateway → API client: deliver events
- HTTP API → Chat and email: handle chat
- HTTP API → Boards and tasks: handle board work
- HTTP API → Team calendar: handle calendar
- HTTP API → Shared documents: handle documents
- HTTP API → Shipping workflow: dispatch shipping
- HTTP API → Agent coordination: start convene
- HTTP API → PostgreSQL: query and persist
- HTTP API → Realtime outbox: enqueue invalidations
- Realtime outbox → Redis: fan out events
- Realtime gateway → Redis: subscribe events
- Agent scheduler → Agent coordination: coordinate work
- Agent scheduler → Agent turns: activate turns
- Agent turns → OpenAI service: request completions
- Agent turns → Runtime API: invoke tools
- Runtime API → PostgreSQL: read and write state
- Managed agent pods → Runtime API: use runtime API
- BYOA daemon → Runtime API: use runtime API
- Managed agent pods → Workspace mount: mount workspace
- Workspace mount → Runtime API: access workspace files
- HTTP API → File storage: store attachments
- HTTP API → Email service: send email
- Email and CDN gates → HTTP API: forward inbound mail
- HTTP API → Push services: send notifications