Skip to main content
Hybrid mode runs the service on your machine (or a VPS) for channel processing, while tasks and contacts are stored in the cloud for team access.

​
What you get

  • Service processes channels locally — messages never leave your machine
  • Tasks and contacts persist in Supabase via the cloud API
  • Team members access shared data through the cloud web UI or mobile app
  • API token (PAK) authentication between service and cloud

​
Setup

​
How data flows

  • Messages are stored locally in SQLite (they never leave the service)
  • Tasks and contacts are created and updated via HTTP calls to the cloud API
  • The cloud API enforces team-scoped access using the PAK token and X-Team-Id header
  • The cloud can push events back to the service via SSE (e.g., Gmail notifications)

​
When to use this mode

  • Teams that want shared task management
  • When channel credentials must stay on a local or private machine
  • When you need the cloud web UI and mobile app access