Caddi
Sign inSign up

Connect GitHub

Caddi creates repos, opens promotion PRs, and listens for push events through a GitHub App. Install it once, on the org you build under.

Why an App, not OAuth?

A GitHub App belongs to the organization, not a user. When someone on your team leaves, the install stays put. Tokens are short-lived and per-install, which is also how rate-limit budgets stay sane.

Install

From the dashboard: Settings → Integrations → GitHub → Install App. You can also install directly:

bash
# Open the install flow
caddi github connect

# Or visit
https://github.com/apps/caddi-build/installations/new

Permissions requested

  • contents: write — push code on your behalf when scaffolding from a template.
  • pull_requests: write — open promotion and revert PRs.
  • administration: write — create repos under the org.
  • workflows: write — write workflow files for the templates that include them.
  • metadata: read — the standard GitHub App baseline.
You can restrict the App to selected repos. We recommend granting All repos on the org Caddi creates projects in — otherwise you’ll have to add each new repo by hand after scaffold.

Verify

bash
caddi github status

# install: northstar-collective
# repos:   all  (12 active)
# rate:    4982 / 5000 remaining

Multiple orgs

You can install the App on more than one GitHub org and pick which one a project lives in at scaffold time:

bash
caddi init --template next-marketing --gh-org northstar-collective

Disconnecting

Uninstall from GitHub at github.com/settings/installations. Caddi marks every project that depended on the install as provider disconnected and stops scheduling deploys until you reconnect.

Next

Connect Vercel →