Connecting Your Repository

GitHub for indexing is separate from signing in with GitHub. Connect once at the account level — it applies to every project in that account.

1. 1Open Settings → Integrations (or click Connect GitHub — it's free on the projects onboarding screen).
2. 2Choose Connect with GitHub (OAuth) or Use personal access token instead.
3. 3Authorize read access. OAuth requests the repo and read:user scopes.

Prefer a fine-grained token when possible:

• Fine-grained: grant Contents: Read and Metadata: Read, and select the repos you need.
• Classic PAT: enable the repo scope.

After connecting you can Update token, Test connection, or Disconnect. Disconnecting stops syncing and removes access to synced data for that account.

1. 1Click Create your first project (or Create New Project).
2. 2Name the project (for example “QEEK Platform” or “My SaaS App”), then click Next.
3. 3Select repositories under Own Repositories or Public Repositories, then click Create Project.

Repository selection is per project. You can add more later from the GitHub icon in the header → Repositories.

On the welcome screen, click Start indexing or Index all N repositories. Typical time is about 10 minutes (often less for smaller repos).

Progress moves through:

• Queued for processing
• Indexing files
• Building search index
• Preparing your workspace

You can leave the page — we keep working and can email you when indexing is ready. When complete, choose Explore architecture, Chat with code, or View issues.

• Expired connection: click Reconnect GitHub on the welcome screen or in Settings → Integrations.
• No repository access: for fine-grained tokens, select the right repos; for classic PATs, enable the repo scope.
• Private repos require a connected GitHub account or token with access.
• Chat works best after sync completes — use View progress on the repositories page if a banner appears.