Guides
Connect GitHub
GitHub is what turns VocxAI from "here's what customers want" into "here's the actual pull request." Connecting it unlocks feasibility checks against your real code, codebase-grounded PRDs, and build agents that open PRs - everything else in the product still works without it, just with less to go on.
Before you start
- You'll need to be an owner or admin of the GitHub organization (or the owner of the personal account) you want to install on - GitHub's own install screen enforces this, not VocxAI.
- Know roughly which repositories you want VocxAI reasoning about. You can grant access to everything and narrow it down inside VocxAI afterward, or grant only specific repos up front on GitHub's side - either works.
Step 1: Start the connection
Go to Settings → Connectors and click Connect on the GitHub card.
Step 2 (optional): Pick an organization first
If you belong to more than one GitHub organization, Choose which organization to install on opens a small popup that lists the ones you're a member of, so the install screen in the next step jumps straight to the right one. This step is entirely optional - skip it and you'll pick the account manually on GitHub's own screen instead.
Step 3: Install on GitHub
Authorise & connect opens GitHub's own installation screen in a new tab. Choose the organization or account to install on, then choose All repositories or select specific ones - this choice is entirely yours, made on GitHub's side, and only the repos you grant here are ever visible to VocxAI.
Step 4: Narrow down what VocxAI actually analyzes
After installing, you'll land on Repo Intelligence - a checklist of every repository the install granted access to. Select the ones you actually want VocxAI reasoning about day to day (feasibility checks, PRDs, build agents) and save.
What this access is actually used for
- Code search - a lightweight check on a newly-discovered theme for whether something like it already exists in your codebase.
- Reading files - grounding PRDs and implementation tasks in your actual repo structure, rather than guessing at file paths and patterns.
- Creating a branch and opening a pull request - once a build agent finishes a change, it opens the PR against your repo's default branch.
One GitHub connection per account
A VocxAI account can have exactly one active GitHub connection at a time. If you reconnect to a different organization or account, it replaces the current connection rather than adding a second one - there's no warning dialog for this today, so only reconnect if you actually mean to switch which org VocxAI is working against.
Disconnecting
Disconnect in Settings → Connectors removes VocxAI's local record of the installation, but it does not uninstall the GitHub App from your GitHub organization. To fully revoke access, also remove the app from your organization's (or account's) installed GitHub Apps in GitHub's own settings.
Troubleshooting
- "vocxai could not inspect the installation" - usually a transient hiccup reading the new installation right after you grant access. Just try Connect again.
- You cancelled partway through - nothing gets connected until the install actually completes on GitHub's side, so it's always safe to just start over from Step 1.
- The app was removed on GitHub's side - if someone uninstalls the GitHub App directly from your org settings, VocxAI picks that up and shows GitHub as disconnected.