Kognita.Connect GitHub
Kognita connects to GitHub through a GitHub App installation. You choose which repositories (or your entire account) Kognita can access — no personal access tokens or SSH keys required.
The connection is at the organization level in Kognita, not per-project. Once connected, you can add any accessible GitHub repo to any project in that organization.
Part 1 — Connect your GitHub account
Open Git connections
In the dashboard sidebar, click Git connections. You'll see rows for GitHub, GitLab, and Bitbucket.
Click Connect next to GitHub
Click the Connect button in the GitHub row. If you previously connected GitHub and want to update which repos are accessible, click Reconnect instead.
Kognita will redirect you to GitHub to install the GitHub App.
Select a GitHub account to install on
GitHub will ask you where to install the Kognita app. You'll see your personal account and any GitHub organizations you have admin access to. Select the one that owns the repositories you want to index.
Choose repository access
GitHub offers two options:
All repositories
Kognita can access all current and future repos in this account. Easiest to set up — no need to update when you create new repos.
Only select repositories
You pick specific repos from a list. More controlled — useful if you want to limit access to certain codebases. You can add more repos later through GitHub settings.
Click Install
Click the Install (or Install & Authorize) button on GitHub. GitHub will redirect you back to Kognita automatically.
Connection confirmed
Back in the dashboard, the GitHub row will show connected with your GitHub account or organization name. The connection is now active for your Kognita organization.
Part 2 — Add GitHub repos to a project
Open a project
Click any project from the Projects view, or create a new one with + New project.
Click + Add repo
In the project detail view, click the + Add repo button in the top-right. The Add repository modal will open.
Select GitHub as the provider
At the top of the modal you'll see provider buttons — GitHub, GitLab, and Bitbucket. Click GitHub. It will be active because you just connected it. Kognita will load the list of accessible repositories.
Search for and select a repository
A search box appears with all your accessible repos. Type to filter by name (e.g. my-app). Private repos are labeled private. Click the repo you want to add.
Confirm the branch
The branch field auto-fills with the repo's default branch. Change it if you want to index a different branch (e.g. develop). You can always update the branch later via the Edit button on the repo.
Click Add
Click Add. The repo appears in your project with a not indexed status. Repeat for any other repos you want in this project.
Index the repositories
Click Index all, confirm in the modal, and wait a few minutes. Kognita indexes every repository in the project together. Status will update to indexed when complete.
Troubleshooting
A repository isn't showing up in the picker
Kognita can only see repos you granted access to during installation. Go to your GitHub account → Settings → Applications → Installed GitHub Apps → Kognita → Configure, and add the missing repo.
I installed on the wrong GitHub account
Go to Git connections and click Disconnect, then Connect again. You'll be sent back to GitHub where you can select a different account.
I need to add repos from a different GitHub organization
You can have multiple GitHub connections in one Kognita organization — just click Connect again and install on a second GitHub account/organization. Both will be available in the repo picker.
The GitHub redirect returned an error
Make sure you have admin access to the GitHub account or organization you're trying to install on. GitHub App installations require admin permissions.