Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.yourhq.ai/llms.txt

Use this file to discover all available pages before exploring further.

An HQ project is a Supabase-backed workspace — your agents, tasks, CRM, documents, and settings all live in one Supabase project that you own.

How it works

Project registry

The UI stores project metadata in /config/projects.json and secrets in /config/secrets.json on the ui-config Docker volume.

Runtime injection

The active project is selected at runtime and injected into the browser — no image rebuild needed when switching projects.

Multi-project support

One UI install can manage multiple Supabase projects. Each project is a fully isolated workspace — HQ does not implement multi-tenant row-level isolation inside a shared database. Instead, each workspace gets its own Supabase project.
Use the project switcher in Settings → Projects to move between workspaces. Each project has its own agents, gateways, tasks, and CRM data.

Isolation model

BoundaryScope
Supabase projectFull isolation — separate database, auth, and realtime
GatewayBound to one project via Supabase credentials
UICan switch between projects at runtime