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.

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.

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.