> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aosplane.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aosplane.io/_mcp/server.

# Connect GitHub

AOSplane needs two GitHub connections before a session can work on a repository: the **Organization GitHub App**, which an admin installs once, and **Your GitHub account**, which each person connects. Both live on the **GitHub** page.

> **Note**
>
> Owners and Admins install, change and disconnect the GitHub App. Everyone except the Billing role can open the page and connect their own account.

## Connect GitHub

#### Open the GitHub page

Open **Settings** (the gear beside your name), choose **Connections**, then **Connect** (or **Configure**) next to **GitHub** under **Source control**.

#### Connect your account

On the **Your GitHub account** card, choose **Connect** and approve AOSplane on GitHub. You come back to **Your GitHub account is connected.**

#### Install the App

On the **Organization GitHub App** card, choose **Connect**. On GitHub, pick the account or organization and choose **All repositories** or only the ones you select.

#### Check the result

Back in AOSplane you see **The GitHub App is connected.** Your repositories show under **Organization repositories**.

#### Link repositories to a project

Pick which repositories each project can use. See [Repositories](/repositories).

![GitHub page with the Organization GitHub App card, the Your GitHub account card and the Organization repositories table](/_fern-files/_img/0f67a8020ef113d5fec2a2038d6927ebdb0e4d496953523501e72efe81ebb991.webp)

If you aren't an owner of the GitHub organization, GitHub sends your install request to its owners. Once one approves it, choose **Connect** again to finish.

## Open pull requests as you

**Create pull requests as your GitHub user** is off by default, so pull requests from your sessions are opened by the AOSplane GitHub App. Turn it on, on the **Your GitHub account** card, to open them under your own account.

## Good to know

* Your account comes first. Installing the App without it fails with "Connect your GitHub account first."
* To change which repositories the App sees, choose **Reconfigure**. New repositories appear within a minute or two; admins can choose **Sync now** to check right away.
* **Organization repositories** lists what the App can reach, with each one's visibility, default branch and status (**Available**, **Archived** or **Disabled**).
* Card badges tell you what to fix: **Suspended** or **Disconnected** means an admin must reconnect the App, and **Expired** means choose **Reconnect** on your account.
* Disconnecting the App stops sessions from cloning or opening pull requests. Disconnecting your account stops pull requests being opened as you.
* Once both are connected, Engineers and admins can mention `@aosplane` on GitHub to start a session or ask for a review. See [Reviews](/reviews#start-work-from-github).

#### Who can do what

|                                                          | Owner, Admin | Engineer | Viewer | Billing |
| -------------------------------------------------------- | ------------ | -------- | ------ | ------- |
| Install, reconfigure or disconnect the App, **Sync now** | Yes          | No       | No     | No      |
| Connect your own GitHub account                          | Yes          | Yes      | Yes    | No      |
| Link or unlink a project's repositories                  | Yes          | Yes      | No     | No      |
| See the GitHub page and repository lists                 | Yes          | Yes      | Yes    | No      |

## Related

* [Repositories](/repositories)
* [Reviews](/reviews)
* [Start a session](/start-a-session)