Connect GitHub
1
Open Settings in the Hyper desktop app
Launch the Hyper desktop app and click Settings in the navigation, then select Connections.
2
Click Connect next to GitHub
Find GitHub in the list of available integrations and click Connect.
3
Install the Hyper GitHub App
You’ll be directed to authorize the Hyper GitHub App on your GitHub account. This is a GitHub App installation — not a personal access token. Using a GitHub App gives Hyper precisely scoped access and is the secure, recommended approach for team use.
4
Select repositories to sync
During the GitHub App installation, choose which repositories Hyper can access — either all repositories on your account or a specific subset. You can update this selection later from your GitHub App settings.
5
Wait for the initial sync to complete
Hyper begins indexing PRs, issues, and markdown files from your selected repositories. Sync progress is visible in Settings → Connections.
6
Add more GitHub accounts (optional)
To connect additional GitHub accounts (for example, a personal account alongside an organization account), return to Settings → Connections and click Connect next to GitHub again.
Hyper uses a GitHub App installation rather than a personal access token. GitHub Apps have granular, auditable permission scopes and can be installed at the organization level — making them suitable for team-wide deployments.
What Hyper Syncs
Hyper reads repository content only — it never creates, edits, or closes PRs, issues, or files on your behalf.
Search GitHub with AI Agents
Once your repositories are indexed, your AI agents can search PRs, issues, and markdown files using powerful filters or natural language. Supported search filters:
Example agent queries:
How Hyper handles large repositories
How Hyper handles large repositories
For repositories with many files, Hyper performs an initial full crawl and then switches to incremental updates based on commit comparisons. Only files changed in new commits are re-indexed, keeping sync fast regardless of repository size.
Reconnect GitHub
If the GitHub App installation is suspended or revoked, Hyper will display a Reconnect prompt in Settings → Connections.1
Go to Settings → Connections
Open the Hyper desktop app and navigate to Settings → Connections.
2
Click Reconnect next to the affected GitHub account
Each GitHub account has its own connection entry. Click Reconnect for the one that needs re-authorization.
3
Re-install or re-authorize the GitHub App
Follow the GitHub App authorization flow. Your previously indexed data is preserved — Hyper resumes sync from the latest commit.