Skip to content

document claiming a github app install #210

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
SyedFahad7 merged 1 commit into from
Nov 5, 2026
Merged

document claiming a github app install #210

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions integrations/github.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,26 @@ Graphify connects to GitHub through the Graphify GitHub App. You choose which re

To add or remove repositories later, change the app's repository access on GitHub, or click **Add GitHub repositories** again.

## Claim an install from github.com

If you installed the Graphify GitHub App from github.com instead of from Graphify, the install is not connected to a workspace yet. Graphify shows it on **Repositories** (and during onboarding) with a **Claim** button.

<Steps>
<Step title="Find the pending install">
Open **Repositories**. Owners and admins see a row for each GitHub account or organization that is installed but not connected.
</Step>
<Step title="Click Claim">
**Claim** proves you control that GitHub install and binds it to your current workspace. You may be asked to confirm on GitHub.
</Step>
<Step title="Index the repositories">
After the claim, the repositories from that install appear in the workspace and can build their graphs.
</Step>
</Steps>

Unclaimed installs stay claimable for a limited time. If the row disappears, install the app again from **Add GitHub repositories**, or from GitHub and claim it while signed in.

If you uninstall and reinstall the Graphify GitHub App on the same GitHub account, your repositories move over to the new install.

## What the app does

- **Indexing.** A push to the default branch starts an index of that commit. Other branches do not change the graph. See [Repositories and builds](/platform/repositories).
Expand Down
2 changes: 2 additions & 0 deletions platform/repositories.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ import HostedMcpCard from '/snippets/hosted-mcp-card.mdx';

Open **Repositories** in [Graphify](https://app.graphify.com). Click **Add GitHub repositories**, or click **Connect** on the GitLab card in **Connectors**, then complete the provider's repository-access flow. Google Drive folders are added from **Connectors**. Follow [Connect Google Drive](/integrations/google-drive).

If you installed the Graphify GitHub App from github.com, owners and admins see a **Claim** button on **Repositories** to connect that install to the workspace. See [Claim an install from github.com](/integrations/github#claim-an-install-from-githubcom).

Return to the repository list to check indexing status. Provider and status filters help narrow a large workspace.

| Status | Meaning |
Expand Down
Loading