Command Panel
Lightning-fast search and command palette for instant navigation.
The SupaSidebar Command Panel is a single keyboard shortcut (Cmd Ctrl K) that jumps you to any resource on your Mac - saved links, browser tabs across every installed browser, recently visited pages, files, folders, apps, and SupaSidebar settings. Fuzzy search matches across all of those sources at once, so you don’t have to know where you saved something to find it. Press Return to open the result in your default browser, Opt Return for a per-item actions menu (choose a different browser, reveal in Finder, add a note), Ctrl Return to ask an AI assistant, or Cmd Return to search the web.
Open Command Panel
Press Cmd Ctrl K from anywhere. You can also enable Cmd T while a browser is active in Preferences - Command Panel to open the Command Panel from inside any browser without changing your global shortcut. Other apps continue to receive Cmd T normally, and SupaSidebar skips this binding if your global shortcut is already Cmd T.
| Shortcut | Action |
|---|---|
Cmd Ctrl K | Open panel |
Up Down | Navigate results |
Return | Open selected |
Opt Return | Actions panel (choose browser, reveal in sidebar/Finder) |
Shift Tab | Cycle search scope |
Ctrl Return | Ask AI |
Cmd Return | Search the web directly |
Escape | Close panel |
What you can search
- Saved Links - All your saved websites, files, and folders
- Recent Items - Recently visited pages you haven’t saved
- Live Tabs - Currently open browser tabs
- Folders - Browse and search inside folders
- Settings - Toggle preferences and run commands
- Web Search - Search the web with your preferred engine
Search scopes
Press Shift Tab to cycle through focused search scopes, or type / to pick one from a list. You can also type a scope keyword and press Tab to activate it.
| Scope | Icon | Activation keywords |
|---|---|---|
| All | Grid | (default) |
| Recents | Clock | ”recents”, “recent” |
| Live Tabs | Globe | ”live tabs”, “tabs” |
| Saved | Tray | ”saved” |
| Spaces | Stack | ”spaces”, “space” |
| Folders | Folder | ”folders”, “folder” |
| Settings | Gear | ”settings”, “tools”, “commands”, “actions” |
The Recents, Saved, Spaces, Folders, and Settings scopes show items even with an empty search query, so you can browse without typing. Switch to Recents to flip through pages you’ve visited recently, or to Saved to skim everything you’ve added to the sidebar.
Fuzzy search
The search is forgiving and intelligent:
- “fecebook” finds “Facebook”
- “gh” finds “GitHub”
- “sup doc” finds “SupaSidebar Documentation”

Search history
The Command Panel remembers your past search queries. When you start typing, matching previous queries appear as suggestions, helping you quickly repeat frequent searches.
Manage suggestions
Open the item options menu (the ⋯ button on a result row) to clean up what shows up in the Command Panel:
- Remove from suggestions - Drops an old search query or recent link from future suggestions
- Delete saved link - Removes a saved link from your sidebar
- Reset ranking - Clears the recency boost on a single item so it stops dominating results
Frequent items
When you open the Command Panel with an empty query, your most frequently used items appear at the top for quick access. The Command Panel also learns which saved links you open most and surfaces them first for short queries (one or two letters), so a single keystroke often gets you to the right link.
Actions panel
Press Opt Return on any selected item to see available actions:
| Action | When available |
|---|---|
| Copy URL | Always |
| Reveal in Sidebar | Saved links |
| Add note | Saved links - opens the note editor for the selected link |
| Save to Sidebar | Unsaved items (uses your search query) |
| Reveal in Finder | Local file and folder links |
| Open in [Browser] | One entry per installed browser |
Press Escape to dismiss the actions panel and return to search results.
Domain autocomplete
Typing a partial host like lo completes to localhost:3000 instead of dropping the port. Domain suggestions preserve the original port, path, and casing of the link they came from.
Clipboard awareness
When you open the Command Panel with a URL on your clipboard, a “Paste and Go” row appears at the top of the results. Press Return to open the URL directly.
Toggle settings
Switch to the Settings scope (Shift Tab to cycle, or type “settings” then Tab) to toggle SupaSidebar preferences directly from the Command Panel without opening Preferences.
Useful entries to know about:
- Dark / Light / Theme - Flips between Light and Dark mode. Search for
dark,light,theme, orappearanceto find it. - Incognito Mode - Pauses recents, search history, and link ranking for the rest of your session. See Incognito Mode.
- Auto-Tile Windows - Toggles auto-tiling on and off. See Tiling.
Air Traffic Control suggestions
When the URL you’re about to open matches a strong pattern (you’ve consistently opened the same domain in the same browser, for example), the Command Panel shows a one-click row that creates an Air Traffic Control open route and opens the link in the suggested browser at the same time. You can decline the suggestion and just open the link as usual.
Draggable positioning
Drag the Command Panel anywhere on screen. It magnetically snaps to center with visual guide lines when you drag near the default position. Release near center to reset, or drop anywhere else to save that position across sessions.
The Command Panel uses a frosted glass design that blends with your desktop while keeping content readable.
Live tab switching
Search for an open tab by title and press Return to switch instantly.
Ask AI
Press Ctrl Return to chat with an AI assistant inside the Command Panel. Search your sidebar, open links, create folders, and more using natural language. See Ask AI for details.
AI assistant integration
SupaSidebar can also be controlled by AI assistants via the Model Context Protocol (MCP). Search your sidebar, switch spaces, and open links hands-free. See SupaSidebar MCP for setup.
Web search
- Open Preferences - Command Panel
- Enable Web search suggestions
- Choose your engine (Google, DuckDuckGo, Bing, Yahoo, Perplexity)
Press Cmd Return to search the web directly with your current query.

Tips
- Use
Shift Tabto quickly narrow results to a specific scope instead of scrolling through everything. - The Settings scope lets you toggle preferences without leaving what you’re doing.
- Drag the panel to a comfortable position - it remembers where you left it.
- See Shortcuts for the complete keyboard shortcut reference.