Browser Selection

Choose which browser opens your links - pick on demand, assign per link, or use your active browser.

Priority Order

When you click a link, SupaSidebar decides which browser to use based on this priority (highest first):

Priority	Method	Example
1. Modifier-click	`Opt`-click, right-click → Open With, `Cmd`-click action	You hold `Opt` and pick Safari - that wins over everything
2. Air Traffic Control	URL-pattern rules in Preferences → ATC	Rule says `github.com` → Chrome, so all GitHub links open in Chrome
3. Per-space browser	Space’s assigned default browser, set in Preferences → Air Traffic Control	Link is from Work space, which uses Chrome
4. Link opening behavior	Global setting: saved browser, frontmost, or default	Your preference is “saved browser” and this link was saved from Firefox
5. System default browser	Whatever macOS is configured to use	Falls back to your default browser

If a higher-priority method applies, lower ones are skipped entirely. For example, if an ATC rule matches a link, it doesn’t matter what browser the link was saved from - ATC wins.

Ways to Select a Browser

Method	How
Right-click	Right-click link → Open With → choose browser
`Opt` click	Hold `Opt` and click a link
`Opt Return`	Select link in Command Panel, press `Opt Return`
Air Traffic Control	Set URL-based routing rules in Preferences → Air Traffic Control. See Air Traffic Control

Keyboard Shortcuts

Shortcut	Action
`Opt` click	Show browser picker
`Opt Return`	Show browser picker (Command Panel)
`↑` `↓`	Navigate picker
`Return`	Select browser
`Escape`	Cancel

Troubleshooting

Issue	Solution
Browser not in picker	Install in Applications folder, restart app
Wrong browser opens	Right-click link → Set Browser → choose correct one
Picker doesn’t appear	Hold `Opt` while clicking/pressing Return
Assignment not saving	Use “Set Browser” (right-click), not one-time `Opt` click