How nickvasilescu/bops works
Bops is a Mac-hosted AI-bot operations app: users chat with workspace bots, which run tasks on cloud computers and report back through chat or connected channels. The Next.js app exposes the user-facing workflows; session orchestration provisions computers and coordinates task execution, while distinct services support memory, apps, communications, and monitoring. Bops Cloud brokers hosted provider access, and an optional edge relay forwards public webhooks. Several subsystem links below are based on README descriptions because their implementation excerpts were not supplied.
Main entry points: sessions.ts Task sessions · server.ts Bops Cloud · bops-app.tsx Bops interface · route.ts App API
Components 23
Mac app
- Desktop shell
desktop/main.cjs - Bops interface
components/app/bops-app.tsx - Chat threads
components/app/chat-view.tsx - App API
app/api/sessions/route.ts
Bot work
- Task sessions
lib/server/sessions.ts - Bot computers
lib/server/orgo.ts - Live screens
lib/server/screens.ts - Mac computer use
lib/server/codex.ts
Bot capabilities
- Long-term memory
lib/server/memory.ts - Connected apps
lib/server/composio.ts - Action approvals
app/api/apps/approvals/route.ts - Team channels
lib/server/channels.ts - Bot email
lib/server/mail.ts - Texts and calls
lib/server/phone.ts - Routines and watches
lib/server/watches.ts
State and services
- App state
lib/server/store.ts - Persistence
lib/server/persist.ts
Hosted services
- Cloud client
lib/server/cloud.ts - Bops Cloud
cloud/server.ts - Cloud accounts
cloud/session.ts - Webhook relay
edge/server.mjs
Other components
- User
- External providers
Connections 29
- User → Desktop shell: opens
- Desktop shell → Bops interface: loads
- User → Bops interface: uses
- Bops interface → Chat threads: offers chat
- Chat threads → App API: submits tasks
- App API → Task sessions: starts sessions
- Task sessions → Bot computers: provisions
lib/server/sessions.ts - Task sessions → App state: updates state
lib/server/sessions.ts - Task sessions → Live screens: coordinates screens
lib/server/sessions.ts - User → Live screens: watches or takes over
- Task sessions → Mac computer use: uses on request
lib/server/sessions.ts - Task sessions → Long-term memory: uses workspace memory
lib/server/sessions.ts - Task sessions → Connected apps: uses connected apps
lib/server/sessions.ts - Connected apps → Action approvals: requests approval
- User → Team channels: asks from channels
- Team channels → Task sessions: starts bot tasks
lib/server/sessions.ts - User → Bot email: emails tasks
- Bot email → Task sessions: starts tasks
lib/server/sessions.ts - User → Texts and calls: texts or calls
- Texts and calls → Task sessions: starts tasks
lib/server/sessions.ts - User → Routines and watches: configures reminders
- App state → Persistence: saves state
lib/server/store.ts - Cloud client → Bops Cloud: sends authenticated requests
lib/server/cloud.ts - Bops Cloud → Cloud accounts: routes session setup
cloud/server.ts - Bops Cloud → External providers: brokers provider access
- Webhook relay → App API: forwards webhooks
- External providers → Team channels: delivers channel events
- External providers → Bot email: provides email
- External providers → Texts and calls: provides telephony