1 - Getting Started
# Getting Started with Ridge Sight
Ridge Sight is a centralized dashboard that brings together open pull requests from all your GitHub repositories into one place. Instead of jumping between repos, you can view, triage, and act on every PR from a single screen.
## What You Can Do with Ridge Sight
- - See all open PRs at a glance — Pull requests from every connected repository appear in one unified list.
- - Save PRs for later — Bookmark pull requests you want to come back to.
- - Dismiss PRs you've handled — Archive PRs so they stop cluttering your view.
- - Merge, comment, and approve — Take action on PRs without leaving the dashboard (Premium).
- - Get AI-powered risk analysis — Let AI summarize the risk profile of any PR (Premium).
- - AI Feed — See PRs ranked by risk signals like conflicts, failing CI, and staleness (Premium).
- - Work items — Claim PRs and track review progress with your team (Premium).
- - Notifications — Get alerts via Slack or Pushover for new PRs, failing CI, and more (Premium).
- - Filter and search — Find exactly the PRs you need with advanced filters.
- - Export your data — Download all your Ridge Sight data as JSON from the settings menu.
## Step 1 — Sign In with GitHub
- - Visit the Ridge Sight login page.
- - Click Sign in with GitHub.
- - You'll be redirected to GitHub to authorize the Ridge Sight app. This grants Ridge Sight read access to your repositories and pull requests.
- - After authorization, you'll be redirected back to the Ridge Sight dashboard.
Note: Ridge Sight uses GitHub OAuth 2.0. Your GitHub password is never shared with Ridge Sight.
## Step 2 — Install the GitHub App
After signing in for the first time, you need to install the Ridge Sight GitHub App on your GitHub account or organization. This tells GitHub which repositories Ridge Sight is allowed to access.
- - On the dashboard, click Manage Access in the repository sidebar.
- - You'll be taken to GitHub's app installation page.
- - Choose which account or organization to install on.
- - Select All repositories or pick specific ones.
- - Click Install.
You can change which repositories the app can access at any time from your GitHub settings.
## Step 3 — Select Repositories to Track
Once the GitHub App is installed, your repositories will appear in the sidebar on the left side of the dashboard.
- - Browse the list of available repositories.
- - Click a repository to select it — selected repositories are highlighted.
- - Use Select All / Deselect All to quickly toggle all visible repos.
- - Click the Refresh button (↺) to re-fetch the latest repository list from GitHub.
Only open pull requests from your selected repositories will appear in the main dashboard.
Free plan: You can track up to 3 repositories. Upgrade to Premium for unlimited repos.
## Step 4 — View Your Pull Requests
After selecting at least one repository, the dashboard will load all open pull requests from those repos. Each PR card shows:
- - Title and PR number
- - Author (with avatar)
- - Repository name
- - When it was created and last updated
- - Draft status — Draft PRs are labeled
- - CI status — Green (passing), red (failing), yellow (pending)
- - Review status — Approved, changes requested, review pending
- - Conflict status — Whether the PR has merge conflicts
- - Labels — Any GitHub labels applied to the PR
Click any PR card to expand it and see the full description and additional details.
## What's Next?
- - Managing Your Repositories — Learn more about organizing your repo selections
- - Working with Pull Requests — Save, dismiss, merge, and filter PRs
- - Plans & Pricing — See what's included in Free vs Premium
- - Notifications & Team Settings — Configure alerts and team defaults
Still need help? Submit a support ticket