Connecting your GitHub account

Connecting GitHub lets Amendary watch your repositories and flag documentation that a change makes stale. Any member of your workspace can connect a GitHub account or organization; only the workspace owner can disconnect one later.

Before you start

Amendary watches repositories through a GitHub App installation, not a personal access token. You authorize the app once per account or organization, then choose which repositories it can see from GitHub's own settings page.

<aside> ✏ If your workspace is suspended (for example, for a billing issue), connecting GitHub is blocked until the suspension is resolved. The page will show the reason.

</aside>

Connect your first GitHub account

1. Go to Settings and select Connect GitHub.
2. You're redirected to GitHub to authorize the Amendary app for your account or organization.
3. Choose whether to install the app on all repositories or select specific ones. You can change this list anytime from GitHub's own installation settings.
4. Complete the install. GitHub redirects you back to Amendary to finish linking.

Result: your account or organization appears in Settings with its repositories available to add. Amendary begins tracking whichever repositories you choose next.

Add repositories to watch

Installing the app grants access; it doesn't automatically start monitoring every repository. From your list of connected accounts, add the specific repositories you want Amendary to check for documentation drift.

Result: each added repository shows in your reprepo list with its last checked time and status, once the next daily check runs.

Connect another account or organization

A single workspace can connect more than one GitHub account or organization at the same time, for example, a personal account for side projects and a company organization for production code. Every repository always belongs to exactly one connected account.

1. Go to Settings.
2. Select Connect another GitHub account (this label appears once you already have at least one connection; it reads Connect GitHub the first time).
3. Repeat the authorization steps above for the new account or organization.

Result: Settings lists every connected account separately, each with its own set of repositories and its own disconnect control. Connecting again never replaces an existing connection.