Setting up your GitHub repository

Every SmixAI organization gets its own private GitHub repository, isolated from every other org. SmixAI hosts it inside the SmixAI GitHub organization and invites your GitHub user as an external collaborator on that one repository — so you get access to your code and nothing else.

There are two ways to do this:

• Connect your own repository — you already have your code on GitHub and want SmixAI to work with it. Do this first: connect GitHub, then point SmixAI at your repository.
• Use a SmixAI-hosted repository — you want SmixAI to make a private repository for you inside the SmixAI GitHub organization, and invite your GitHub user to it.

A few GitHub words used below, in plain terms:

• Repository (or "repo") — the place your code lives on GitHub.
• Connect — give SmixAI permission to see and work with your repository. You do it once, on GitHub. There is nothing to copy or paste.
• Pull request — a proposed change to your code that a person reviews before it goes in. SmixAI opens these; it never changes your code without one.

Connect your own repository

Do these two things, in order.

Step 1 — Connect GitHub

1. Open Integrations in the left menu.
2. Find the GitHub card and click Connect (then Connect with GitHub). There is nothing to copy or paste — no Client ID, no Secret. SmixAI uses its own GitHub app.
3. GitHub opens and asks you to allow SmixAI. Sign in with the GitHub account that can reach the repository you want to connect, and approve.
4. GitHub sends you back to SmixAI, connected.

You should see: GitHub now shows as connected. SmixAI can see your repositories — including private ones.

What connecting allows. The connection can reach every repository the GitHub account you sign in with can see. SmixAI only reads code and opens pull requests on the one repository you pick in Step 2 — never any other. For the tightest access, sign in with a GitHub account that can reach only the repositories you want SmixAI to work with.

Connect GitHub before the next step. Until you do, SmixAI cannot see a private repository, and the next step will say it could not find it.

Step 2 — Point SmixAI at your repository

1. Open Settings and find the Repository card (admin only).
2. Choose I already have my own repo.
3. Pick your repository from the list — it shows the repositories SmixAI can see for the account you signed in with. If you don't see it (or would rather type it), enter it as owner/name — for example acme-corp/website — exactly as shown at the top of your repository's page on GitHub.
4. Click to save.

You should see: the card shows your repository as connected. No invite is needed — it is your own repository. SmixAI is now ready to read your code and open pull requests on it.

Use a SmixAI-hosted repository instead

If you'd rather SmixAI create the repository for you, the Repository card under Settings (admin only) walks you through six steps, and each one verifies before you move on.

The six steps (SmixAI-hosted)

1. GitHub username — Enter the GitHub username of the person who will work on the repo. This is the account we invite as a collaborator, so it must be an existing GitHub account. If you don't have one yet, create a GitHub account first, then come back and enter the username.
2. Check for an existing repository — SmixAI scans to see whether a repository already exists for your org. If one does, you can adopt it; if not, you'll create one in the next steps.
3. Choose your repository — Pick one:
   • SmixAI-hosted private repo — we create a private repository for you.
   • I already have my own repo — pick it from the list of repositories SmixAI can see (or type it as owner/name) and we'll point SmixAI at it instead (no invite needed, since you already own it).
4. Set up the repository — Provision the SmixAI-hosted repo (idempotent — safe to re-run), or verify and designate the repo you supplied. When it's ready you'll see a link to it.
5. Invite as external collaborator — SmixAI sends your GitHub user an invitation to the repo with maintain access. Accept it from the GitHub email (or the Open invitation link on the card), then click Verify acceptance. This step is skipped when you brought your own repo.
6. All set — Once access is verified, the card turns green and the repository is ready for the code-fix and rollback flows.

What SmixAI can and cannot do with your repository

• SmixAI can read your code and open pull requests — proposed changes that you review before they go in.
• SmixAI cannot delete your repository, and it never changes your code without a pull request you can see.

Something went wrong?

• "Could not find owner/name." Two common reasons: you have not connected GitHub yet (do Step 1 above first — a private repository is invisible to SmixAI until you do), or the name is not quite right. Copy the exact owner/name from the top of your repository's page on GitHub.
• The repository you want isn't in the list. SmixAI can only see repositories the GitHub account you signed in with can reach. Open Integrations → GitHub → Connect and connect again with an account that can reach it — or just type the repository as owner/name in Step 2. It is safe to connect more than once.
• GitHub says you cannot authorise. You need access to the repository (or its GitHub organization) with the signing-in account. Ask whoever owns the repository to do Step 1 with their account, or to grant your account access, then try again.
• You want to disconnect. On GitHub, open Settings → Applications → Authorized OAuth Apps (for your account) and remove SmixAI. SmixAI then loses access and shows the repository as disconnected.

Notes

• A SmixAI-hosted repository is private and lives inside the SmixAI GitHub organization. You are invited to only your repository — never to the organization itself — which is how tenants stay isolated.
• New organizations get a SmixAI-hosted repository automatically when the org is created; this card lets you create, adopt, or verify it on demand.
• If you see a note that "the GitHub App isn't configured," the SmixAI-hosted collaborator invite step is temporarily unavailable on this environment. Connecting your own repository (the two steps above) does not use the GitHub App and still works — or ask your SmixAI administrator to finish the GitHub App setup.