Connect GitHub
Open Settings in the Hyper desktop app
Launch the Hyper desktop app and click Settings in the navigation, then select Connections.
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.
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.
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.
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
| What’s synced | Details |
|---|---|
| Pull requests | Title, description, comments, review discussions, and state |
| Issues | Title, body, comments, labels, and state |
| Markdown files | All .md and .mdx files in the repository tree |
| Incremental updates | New commits trigger re-sync via commit comparison — only changed files are re-indexed |
| Multi-repo | You select which repositories to sync at install time |
| Multiple accounts | Each GitHub account is a separate connection |
| Source links | Each item links back to https://github.com/{owner}/{repo}/blob/main/{path} |
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:| Filter | Example | What it does |
|---|---|---|
author: | author:alice | Items created by a specific user |
state: | state:open | Filter by open or closed state |
is:pr | is:pr | Pull requests only |
is:issue | is:issue | Issues only |
is:merged | is:merged | Merged pull requests |
is:draft | is:draft | Draft pull requests |
| Action | Description |
|---|---|
| Search PRs | Query pull requests with state, author, and type filters |
| Search issues | Query issues with status, author, and label filters |
| Search markdown | Full-text search across all indexed .md and .mdx files |
| Read by reference | Fetch a specific PR, issue, or file using owner/repo#number or a file path |
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.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.