Connect GitHub

What it does

Connecting GitHub gives Cleo HQ a place to store your project's source code. Every feature your workers build is committed to a private repository under your account. On the Builder tier and above, this also enables automated builds — Ada can push code, create branches, and open pull requests without you touching a terminal.

How to connect

  1. Open Settings from the avatar menu in the sidebar.
  2. Go to the Integrations tab.
  3. Click Connect GitHub and authorize Cleo HQ when prompted.
  4. Once connected, your GitHub username and avatar appear in the integration card.

What permissions are requested

Cleo HQ requests repository access (read and write) so it can create private repos for your projects and push code on your behalf. No access to your personal profile, billing, or organisation settings is requested.

GitHub App vs OAuth

Cleo HQ offers two connection methods:

  • OAuth (default) — Grants basic repository access for browsing files, creating repos, and pushing code. Available on Builder+ plans.
  • GitHub App — Adds automated CI/CD capabilities. The GitHub App can receive webhooks, trigger workflow runs, and manage fine-grained permissions per repository. Available on Builder+ plans.

Most founders start with OAuth. If you later need automated testing or deployment pipelines, you can install the GitHub App from the same Integrations tab.

How to disconnect

Open Settings > Integrations and click Disconnect next to your GitHub account. Your repositories remain on GitHub — Cleo HQ simply loses access to them. You can reconnect at any time.