Filtering & Search

Structured filters, text search, filter presets, and branch author filtering.

git-switchboard offers two ways to narrow what's shown: structured filters that target specific fields, and free-text search that matches across titles, repos, and branches.

Structured Filters

Press f in the PR dashboard to open the filter modal. Each field can be set independently and all active filters are combined with AND logic — a PR must match every filter to appear.

                                                                
          Filters (2 active)                                    
         ──────────────────────────────────────────────         
                                                                
            Organization                                        
          > Repository                                          
            Author                                              
            Linear Issue                                        
            Role                                                
            Review Status = approved, changes-requested         
            CI Status = failing                                 
            Merge Status                                        
                                                                
            ✗ Clear all filters                                 
            + Save as preset                                    
            Close                                               
                                                                
          Enter/Space select | d delete preset | Esc

String Filters

String filter fields (Organization, Repository, Author, Linear Issue) open a text input with autocomplete suggestions drawn from your current PR list. Type to narrow the suggestions, then press Enter to confirm.

Press Tab inside the string picker to toggle between fuzzy and exact matching:

Fuzzy — the value is matched as a substring (case-insensitive). Useful for partial matches like "backend" to find "acme/backend-api".
Exact — the value must match exactly. Shown with quotes in the filter summary (e.g. "acme/backend-api").

Multi-Select Filters

Multi-select fields (Role, Review Status, CI Status, Merge Status) open a checkbox list. Press Enter or Space to toggle each option. Press Esc to apply and return to the field list.

                                                                
          CI Status                                             
         ──────────────────────────────────────────────         
                                                                
          > [ ] Passing                                         
            [✓] Failing                                         
            [ ] Pending                                         
            [ ] Mixed                                           
            [ ] Unknown                                         
                                                                
          Enter/Space toggle | Esc apply & back

Filter Presets

Once you have a useful filter combination, select + Save as preset in the filter modal to name and save it. Saved presets appear at the top of the filter list with a ★ marker. Press d on a preset to delete it. Presets are stored per-view in your git-switchboard config file.

Text Search

Press / in either the PR dashboard or the branch picker to enter search mode. Type your query — results filter in real time. The search matches against:

PR dashboard — PR title, repository ID, head branch, author, and linked Linear issue identifiers.
Branch picker — branch name and linked Linear issue identifiers.

Press Esc to clear the search and exit search mode. Press Enter, Tab, or an arrow key to keep the filter active and return to normal navigation.

Branch Picker Author Filter

  git-switchboard  Remote: OFF | Author: All
    Branch                Author             Updated            PR             
    feat/add-pr-dashboard craigory           3d ago             #42 Open       
    fix/auth-token-refre… craigory           2d ago             #38 Open       
  * main                  craigory           1d ago             -              
    chore/update-deps     dependabot         4d ago             #45 Draft      
    feat/branch-filters   craigory           6d ago             -              
    fix/unicode-rendering alex               5d ago             #47 Open       
  [↑\↓] Navigate | [⏎] Select | [r]emote | [a]uthor | [p]roviders | [/] Search 

The branch picker has a built-in author filter. Press a to cycle through:

All — show all branches.
Me — show only branches authored by the current Git user.
Team — show branches from a predefined author list (configured via --author flags).

All docs

StatusREAD