7 - Troubleshooting & FAQ
# Troubleshooting & FAQ
Common issues and frequently asked questions about Ridge Sight.
## Common Issues
### I can't see any repositories in the sidebar
Cause: The Ridge Sight GitHub App hasn't been installed on your GitHub account or organization.
Fix:
- - Click Manage Access in the repository sidebar.
- - Install the GitHub App on your account or organization.
- - Select which repositories the app can access.
- - Return to Ridge Sight and click Refresh (↺).
### My repository is missing from the list
Cause: The GitHub App doesn't have access to that repository.
Fix:
- - Click Manage Access in the sidebar.
- - On the GitHub App installation settings page, add the missing repository.
- - Click Refresh (↺) in Ridge Sight.
### No pull requests are showing up
Possible causes:
- - No repositories are selected — select at least one in the sidebar.
- - The selected repositories have no open PRs — check on GitHub.
- - Your session has expired — sign out and sign back in.
### I'm seeing "Unauthorized" or getting redirected to the login page
Cause: Your session has expired or your access token is no longer valid.
Fix:
- - Click Sign Out (or visit the login page).
- - Sign in again with GitHub.
Sessions last 7 days on the Free plan and 30 days on Premium.
### I hit a rate limit
Cause: You've exceeded the hourly API request or PR expansion limit for your plan.
What to do:
- - Wait a few minutes — the rate limit uses a sliding window, so capacity gradually recovers.
- - Free plan: 60 API requests/hour, 5 PR expansions/hour.
- - Premium plan: 600 API requests/hour, unlimited PR expansions.
- - Consider upgrading to Premium for higher limits.
### I can't merge a PR from Ridge Sight
Possible causes:
- - Not on Premium — Merging requires a Premium subscription.
- - Merge conflicts — The PR has conflicts that must be resolved on GitHub first.
- - Failed CI checks — The repository may require checks to pass before merging.
- - Branch protection rules — GitHub branch protection may require specific reviews or status checks.
### AI Insights button isn't showing
Possible causes:
- - Not on Premium — AI Insights is a Premium-only feature.
- - Feature not enabled — AI Insights may be temporarily disabled. Check back later.
### My AI Insights budget is exhausted
Cause: You've reached your monthly spending limit for premium AI models.
What to do:
- - The included model (unlimited) is always available — switch to it for the rest of the month.
- - Purchase a top-up pack from the AI Billing modal.
- - Increase your monthly budget in the AI Billing settings.
- - Budgets reset at the start of each calendar month.
### I downgraded from Premium and lost repos
What happened: When you downgrade to Free, the system keeps your 3 most recently selected repositories active and deactivates the rest.
Your data isn't deleted — if you upgrade again, all your previous selections will be restored.
### Dark mode / theme not working
Ridge Sight supports light and dark themes. To switch:
- - Click your profile menu (gear icon) in the top-right corner.
- - Select Theme and choose Light, Dark, or System.
If the theme isn't applying correctly, try refreshing the page.
### How do I set up notifications?
Notifications are a Premium feature. See Notifications & Team Settings for setup instructions for Slack and Pushover integrations.
## Frequently Asked Questions
### What permissions does the GitHub App need?
Ridge Sight requires:
- - Pull requests: Read (to display PRs on the dashboard)
- - Contents: Read (to check merge conflict files)
- - Commit statuses: Read (to show CI status)
- - Email addresses: Read (for account identification)
Write actions (merge, comment, approve) use your personal OAuth token, not the app's permissions.
### Can I use Ridge Sight with GitHub Enterprise?
Ridge Sight works with GitHub.com (cloud). GitHub Enterprise Server (self-hosted) is not currently supported.
### Does Ridge Sight store my code?
No. Ridge Sight reads PR metadata (titles, authors, labels, status) through the GitHub API but does not download, store, or cache your source code.
### Can my teammates see my saved/dismissed PRs?
No. Saved and dismissed PRs are private to your account. Other users cannot see your saved or dismissed lists.
### What happens if I revoke the GitHub App?
If you uninstall the Ridge Sight GitHub App from your GitHub account:
- - Ridge Sight will no longer be able to access your repositories.
- - Your Ridge Sight account and data (saved PRs, preferences) are preserved.
- - You can reinstall the app at any time to resume use.
### How do I delete my account?
- - Click your profile menu (gear icon) → Delete Account.
- - Type your username to confirm.
- - Click Delete.
This permanently removes all your data including saved PRs, preferences, notification settings, and session data.
### How do I export my data?
- - Click your profile menu (gear icon).
- - Click the Export Data button (download icon).
- - A JSON file containing all your Ridge Sight data will be downloaded.
### Is there a mobile app?
Not currently. Ridge Sight is a web application optimized for desktop and tablet browsers. The responsive design works on mobile browsers, but there is no native mobile app.
### How do I contact support?
Visit out Support Portal
## Related Articles
- - Getting Started with Ridge Sight — Setup walkthrough
- - Plans & Pricing — Plan limits and upgrade info
- - Security & Privacy — Data protection details
- - Notifications & Team Settings — Configure alerts and team defaults
Still need help? Submit a support ticket