GitHub Connection

How it works

ArcLume connects to GitHub via a GitHub App. The app requests read access to your repository contents and metadata — it never writes to your repos.

Installing the GitHub App

1. Go to Settings → Repos in your organization
2. Click Connect Repository
3. You'll be redirected to GitHub to install the ArcLume app
4. Choose whether to install for your personal account or a GitHub organization
5. Select which repositories to grant access to (you can choose all or specific repos)
6. Complete the installation and you'll be redirected back to ArcLume

Connecting repositories

After the GitHub App is installed, your available repositories appear in the connection dialog. Select the repos you want to connect, and ArcLume begins indexing them automatically.

Multiple installations

You can install the GitHub App on multiple GitHub accounts or organizations and link them all to a single ArcLume organization. This is useful if your code is spread across multiple GitHub owners.

Automatic re-indexing

ArcLume listens for GitHub push webhooks. When you push new commits to a connected repository, it automatically re-indexes to keep your code context up to date.

Managing repositories

From Settings → Repos, you can:

• View all connected repositories and their indexing status
• Trigger manual re-indexing or full re-index
• Configure exclusion patterns per repo
• Browse indexed code chunks and detected interface points
• Disconnect a repository (removes its indexed data)