Repo Status & Drift Detection
Monitor sync health and detect when files drift out of sync.
The Repo Status page provides an at-a-glance view of synchronization health across all your connected repositories. Drift detection automatically identifies when target files have diverged from their source, so you can take action before inconsistencies cause problems.
How Drift Detection Works
Drift occurs when a file in a target repository no longer matches the expected state from the source repository. This can happen when:
- Someone edits a synced file directly in the target repository
- A sync PR is closed without merging
- External processes modify synced files
Repo File Sync periodically checks target repositories against their source configuration and flags any files that have drifted.
Status Indicators
Each repository in the Repo Status view shows one of the following states:
| Status | Meaning |
|---|---|
| In Sync | All synced files match their source — no action needed |
| Drifted | One or more files have diverged from the source |
| Untracked | The repository is connected but has no sync rules configured |
Summary Cards
At the top of the Repo Status page, summary cards show:
- Total repositories connected to your organization
- In sync count — repositories with no drift
- Drifted count — repositories with detected drift
- Untracked count — repositories without sync rules
Resolving Drift
When drift is detected, you can resolve it by:
- Re-running the sync task — this creates a new PR to bring the target back in sync with the source
- Reviewing the changes — check what was modified in the target and decide if the drift is intentional
- Updating sync rules — if the drift is intentional, adjust your sync rules to accommodate the change
Drift Notifications
You can configure email notifications to be alerted when drift is detected. Set this up in Settings → Notifications → Drift Notifications.
Best Practices
- Check repo status regularly to catch drift early
- Enable drift notifications so you don't have to check manually
- Investigate drifted repos promptly — drift often indicates an unintended manual edit
- Use the summary cards to quickly gauge overall sync health
Next Steps
- Learn about Sync Tasks to understand how synchronization works
- Set up Integrations to connect more repositories