> ## 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.

# Troubleshooting

> Fixes for the most common issues when connecting, syncing, or running tests.

## Sync problems

**Sidebar shows "Last sync failed"**
Try clicking **Sync Codebase** again. If it keeps failing, check **Configuration → CI / Repos** for a connection health warning. Your GitHub connection may need to be re-provisioned or reconnected.

**"No tests found" after syncing**
Double-check the **Tests directory** and **Spec file extensions** under **Configuration → Codebase**. Watchtower only imports files that match both.

**A test I expected to see is missing**
If a test's title changed in your repository, Watchtower keeps it as an **abandoned** test rather than deleting it, so your history and comments aren't lost. Open it from Test Center's **Abandoned** filter and use **Rebind to a renamed test** to reconnect it. See [Test Center](/v0.5.0/test-center#triage).

## Connection problems

**"Something went wrong connecting the repo"**
This usually means the GitHub App installation didn't complete, or access to the selected repository was revoked. Go to **Configuration → CI / Repos** and try **Connect GitHub** again.

**I disconnected a repository but it's still installed on GitHub**
Disconnecting in Watchtower only stops Watchtower from using that repository; it doesn't remove the GitHub App itself. Manage or fully revoke access from your GitHub account or organization settings.

**Watchman isn't posting reviews**
Confirm AI analysis is turned on under **Configuration → Watchman**, and check that the **Review Target** is set to a destination that's actually available (GitHub is supported today; Linear is not yet available even though it's shown in the picker).

## Patrol problems

**A run's progress bar isn't moving smoothly**
For runs dispatched to CI, Watchtower can't see per-test progress until results are reported back; the progress indicator shows a general sweep rather than an exact percentage in that case. Check the console panel for live log output in the meantime.

**I can't change a test's status by hand**
If a test is controlled by Patrol (tagged `AUTO` and automated), its status reflects the most recent run and can only change by running Patrol again. This is by design, so automated results can't drift from manual edits.

**"'\<suite>' is already running"**
Only one run per suite can be active at a time. Wait for it to finish, or use **Cancel All** to stop it and start a new one.

## Reports & comparisons

**Compare says "Not enough data to compare"**
You need at least two recorded Patrol runs before Compare can show a delta. Run Patrol again and try once a second run has completed.

## Notifications

**Not receiving release emails**
Email release notifications are off by default. Turn them on under **Configuration → Codebase → Notifications**, and confirm your address is included as the repository owner or listed under **Additional recipients**.