Repo structure

yourhq/
  apps/ui/              Next.js dashboard (App Router, Tailwind, shadcn)
  apps/migrate/         Database migration runner CLI (yourhq-migrate)
  apps/worker/          Hosted-mode worker service (Stripe, E2B, Resend) — behind `hosted` profile
  gateway/              Gateway image, files API, daemons, lifecycle scripts
  gateway/connectors/   Source connector plugins (one folder per provider + registry)
  gateway/plugins/      HQ plugin system (SDK, template, built-in plugins, contributor guide)
  gateway/daemons/      Python daemons (command runner, dispatcher, source sync, secrets sync, plugin runner, etc.)
  db/migrations/        Supabase SQL migrations (001–039)
  templates/            Agent template library (16 templates)
  installer/            Interactive install scripts (install.sh + install-gateway.sh)
  docs-site/            Mintlify documentation source (docs.yourhq.ai)
  scripts/              Operational and build scripts
  .github/workflows/    CI and image publishing

UI

apps/ui/ — the Next.js dashboard. Server actions in src/app/dashboard/*/actions.ts, components in src/components/, hooks in src/hooks/.

Gateway

gateway/ — Dockerfile, entrypoint.sh, files_api.py, daemons in daemons/, lifecycle scripts in scripts/.

Templates

templates/ — one directory per agent role. Each is a starting worktree for new agents.

Migrations

db/migrations/ — ordered SQL files. Schema source of truth.

Read Architecture for how these pieces interact at runtime.

Local development Contributing

Start here

Hosted

Self-host

Use Your HQ

Concepts

Design

Reference

Development

Security and troubleshooting

Repo structure

UI

Gateway

Templates

Migrations