PR Workflow

How to navigate from the PR dashboard to CI details and open a PR in your editor.

The git-switchboard pr command opens a full PR dashboard that lets you track open pull requests across all your GitHub repositories, inspect CI status and review state, and jump straight into a local worktree — all without leaving the terminal.

PR Dashboard

Run git-switchboard pr to open the dashboard. Each row shows one open pull request with live CI and review badges. Rows are colour-coded: a green dot means all checks passed, amber is pending, and red signals a failure. The review badge shows whether the PR is approved, has changes requested, or is waiting for reviewers.

  git-switchboard pr  6 open PRs                                                             
      PR # PR                   Repo              Updated↓    CI             Diff        Rv↑
  ✎  #42  Add interactive PR d git-switchboard   2h ago      3✓                         ✓      
  ✎  #15  Fix unicode table re opentui           3d ago      1✓                         ✓  
  →  #127 Refactor auth middle backend-api       5h ago      1✓ 1✗       ✗              ✗  
  →  #301 Add retry for failed frontend          6h ago      2✓ 1✗       ✗              ~  
  ✎→ #89  Add branch filter by git-switchboard   1d ago      2✓                         …  
  ✎  #8   Update Homebrew form homebrew-tap      4d ago      ?                          …  
  [↑↓] Navigate | [⏎] Select | [c] Fetch CI | [^R]efresh all | [s]ort | [C]olumns | [f]ilter
  [p]roviders | [/] Search | [~] Debug | [q]uit

Use j/k or the arrow keys to move between rows. Press c on any PR to fetch or refresh its CI status. Press r to retry failed checks (only shown when the selected PR has failures). Use / to filter by title or repo, and s to open the sort modal.

PR Detail View

Press Enter on any PR to open its detail view. This shows all CI check runs with pass/fail icons, the time each check took, and the current review state. Checks are sorted so failures appear first.

  #127 Refactor auth middleware for OAuth2 flow                                               
  acme/backend-api  |  Branch: refactor/auth-middleware  |  Open  |  Updated: 5h ago          
  Actions
    > Open in editor                                                                           
    > Open PR in browser
  CI Checks (4) - fetched just now
     Check                                 Result      Time                                  
   ✗ test                                  failure     Completed in 3m, 4m ago       [open]   █
   ✓ build                                 success     Completed in 3m, 5m ago       [open]   █
   ✓ lint                                  success     Completed in 3m, 3m ago       [open]   █
  Reviews (1)
   ✗ sarah — changes requested (30m ago)
  [↑↓] Navigate | [⏎] Select | [c]opy logs | [^R]efresh | [r]etry failed | [w]atch
  [p]roviders | [~] Debug | [←] Back | [q]uit

From the detail view you can:

Press Enter on a check run to open its logs in your browser, or press Enter at the top to open the PR in your editor.
Press c to copy the logs of the selected check to your clipboard.
Press r to re-run failed checks via the GitHub API.
Press w to toggle watch mode — the view will auto-refresh CI until all checks complete.
Press Left, Backspace, or Esc to return to the dashboard.

Opening a PR in Your Editor

When you press Enter at the top of the detail view (or on the PR row in the dashboard), git-switchboard scans your local filesystem for existing clones of the repository. If it finds one or more, the clone prompt appears so you can choose where to open the PR.

  Select clone for acme/backend-api (branch: refactor/auth-middleware)
    ~/repos/backend-api (clean)                                                
  * ~/repos/worktrees/backend-api/refactor-auth (dirty, on branch) [worktree]
    + Create new worktree
  [↑\↓] Navigate | [⏎] Select | [←] Back

The list shows every local clone, indicating whether it's a worktree, whether it's clean, and whether it already has the PR branch checked out. Select an existing clone and press Enter to check out the branch and open your editor there. Choose + Create new worktree to type a path for a fresh worktree — the branch will be checked out automatically.

If no local clone exists, git-switchboard will prompt you to clone the repository before opening it.

All docs

StatusREAD