> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watchtower.systems/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting a Repository

> Connect GitHub, choose a test source, and manage connected repositories.

Watchtower needs access to a repository before it can build a test inventory or run Watchman analysis. All repository connections are managed from **Configuration → CI / Repos**.

## Connect with the GitHub App

1. Open **Configuration → CI / Repos** and click **Connect GitHub** (or **Connect another repo** if you already have one connected).
2. You'll be sent to GitHub to install Watchtower's GitHub App and choose which repositories to grant access to.
3. Once you're back, the repositories you selected appear under **Repositories**.

## Choosing your test source

Watchtower tracks one repository at a time as your **test source**, the one it scans for Playwright or Cypress spec files. The first time you connect, you'll be asked directly which repository that should be, with an automatically detected framework badge and spec count to help you decide. You can pick **None (Watchman analysis only)** if you don't want a tracked test inventory yet.

To change your test source later, go to **Repositories** and select a different repo's radio button, then confirm with **Apply**. Repositories that aren't your test source still show up under **Watchman only** and continue to get AI analysis on their pull requests and commits.

## Managing connected repositories

Each connected repository has a menu with:

* **Run tests** (test source only): triggers a CI run for that repository directly from Watchtower.
* **Re-provision** (test source only): re-installs Watchtower's reporting workflow and refreshes its access if a connection starts acting up.
* **Disconnect**: removes the repository from Watchtower.

<Note>
  Disconnecting a repository in Watchtower doesn't uninstall the GitHub App or remove its secrets from GitHub. Manage those directly from your GitHub account or organization settings if you want to fully revoke access.
</Note>

Use **Disconnect all** to remove every connected repository at once.

## Connecting a repository manually

If a repository can't use the GitHub App (for example, it's hosted outside GitHub), the **CI / Repos** tab includes manual setup instructions for **GitHub Actions** and **GitLab CI**. These provide a workflow file to add to your repository along with the ingest URL and token it needs to report results back to Watchtower.