# SupaSidebar

> A macOS sidebar app that works with any browser - Safari (including Safari Technology Preview), Chrome, Firefox, LibreWolf, Edge, Arc, Brave (including Brave Origin), Vivaldi, DuckDuckGo, Norton Private Browser, and 25+ more. SupaSidebar gives you Spaces, Pinned Links, Live Tabs, a Command Panel, Smart Folders, and Air Traffic Control routing, with iCloud sync across Macs.

## Getting started

- [Installation and setup](https://docs.supasidebar.com/gettingStarted): Install and configure SupaSidebar on macOS 14+
- [Permissions](https://docs.supasidebar.com/gettingStarted/permissions): Required macOS Automation and Accessibility permissions
- [Browser Support](https://docs.supasidebar.com/gettingStarted/browserSupport): All 25+ supported browsers and their integration levels (Basic, Live Tabs, Profile Spaces)
- [Languages](https://docs.supasidebar.com/gettingStarted/languages): Supported localization languages

## Features

- [Sidebar Panel](https://docs.supasidebar.com/features/sidebar): The floating sidebar interface, multi-screen support, left/right positioning, drag-to-resize, custom per-link colors, adjustable text size, notes on links. Includes the Bring Browser to Front on Show toggle, Auto-Switch Side on Clipped Browser, and the When Sidebar Opens / When Sidebar Hides menus that control browser layout on show and hide
- [Folder Browser](https://docs.supasidebar.com/features/folderBrowser): Finder-style column popover for saved folders, single-click open, Quick Look, Open With, Move to Trash, hover preview (with an Off option to require an explicit click), and Finder actions on file-type links
- [Spaces](https://docs.supasidebar.com/features/spaces): Workspace organization with per-space group-by, collapse/expand all folders, the space options menu, and mouse-wheel or trackpad-swipe space switching
- [Browser Profiles](https://docs.supasidebar.com/features/profileSpaces): Link a browser profile or whole browser to a space for session isolation
- [Link Open Tabs to Space](https://docs.supasidebar.com/features/linkOpenTabs): Per-space tab memory that closes tabs on leave and reopens them in the original browser and profile on return, with lockable tabs that persist everywhere
- [Pinned Links](https://docs.supasidebar.com/features/pinnedItems): Up to 12 pin slots with `Cmd Opt 1-9` and `Cmd Opt 0`, custom shortcuts for slots 11 and 12, and optional numpad shortcuts
- [Recent Links](https://docs.supasidebar.com/features/recentItems): Auto-tracked 30-day browsing history across all supported browsers, shown in every space, with compact / detailed view modes
- [Air Traffic Control](https://docs.supasidebar.com/features/airTrafficControl): URL-pattern rules that auto-route saved links into the right space (and optional folder), and open links in the right browser. Includes smart history-based suggestions and a one-click rule prompt from the Command Panel
- [Power-ups](https://docs.supasidebar.com/features/powerUps): Per-link superpowers including Auto-update Link for episodic content and Open Next episode
- [Smart Folders](https://docs.supasidebar.com/features/smartFolders): Rule-based folders that auto-organize by URL, tag, or date
- [Tags](https://docs.supasidebar.com/features/tags): Organize and filter saved links with tags, with AI tag suggestions from OpenAI, on-device MLX models, Ollama, or any OpenAI-compatible server
- [Trash](https://docs.supasidebar.com/features/trash): Deleted links move to the Trash where you can restore them, delete them permanently, or empty it, with a configurable 7 to 90 day retention window before they are auto-removed
- [Command Panel](https://docs.supasidebar.com/features/commandPanel): Single-keyboard-shortcut launcher (`Cmd Ctrl K`, plus a magnifying-glass button in the compact sidebar top bar) that searches saved links, open browser tabs, recent pages, files, folders, and SupaSidebar settings at once. Saved-link search spans every Space, not just the current one. Includes most-used boost, scopes, Add note action, domain autocomplete, theme toggle, and one-click Air Traffic Control rule suggestions
- [Ask AI](https://docs.supasidebar.com/features/askAI): Natural-language AI assistant inside the Command Panel
- [Sidebar Access](https://docs.supasidebar.com/features/sidebarAccess): Floating button, mouse triggers, and dock mode
- [Live Tabs](https://docs.supasidebar.com/features/liveTabs): Real-time bird's-eye view of every open tab across every browser on your Mac (Safari + Safari Technology Preview, Chrome, Firefox, LibreWolf, Edge, Brave, Vivaldi, DuckDuckGo, Orion, Helium, Dia, and 20+ more), with per-URL custom colors, view-mode switch (compact / detailed), right-click Open With to copy any tab to a different browser or profile, Move to Browser to move a tab and close the original, and `Cmd Opt Click` to replace the active tab on saved links and pinned tabs
- [Browser Integration](https://docs.supasidebar.com/features/browserIntegration): Sidebar layout (Attached or Independent) plus separate "When Sidebar Opens" (do nothing / prevent overlap / fill the freed space) and "When Sidebar Hides" (restore the browser / expand to fill / leave it) menus. Fill works in both Attached and Independent layouts. Auto-tile, Auto-Switch Side on Clipped Browser, profile-aware targeting
- [Link Preview](https://docs.supasidebar.com/features/linkPreview): Mini preview window for saved links; a Tooltip Delay switch in Preferences turns hover previews on or off, with an Instant / 1 / 2.5 / 5 sec delay dropdown
- [Shortcuts](https://docs.supasidebar.com/features/shortcuts): Complete keyboard shortcut reference
- [Privacy Blocklist](https://docs.supasidebar.com/features/privacyBlocklist): Permanently hide specific sites, domains, or browsers from Live Tabs and Recents
- [Incognito Mode](https://docs.supasidebar.com/features/incognitoMode): Pause Recents, search history, and link ranking for the rest of your session. Live Tabs keep working because they save nothing
- [MCP](https://docs.supasidebar.com/features/mcp): Model Context Protocol integration for AI assistants
- [iCloud Sync](https://docs.supasidebar.com/features/sync): Multi-device sync via iCloud across all your Macs

## How to

- [Save links](https://docs.supasidebar.com/howTo/savingLinks): Every method for saving links and adding notes
- [Open links](https://docs.supasidebar.com/howTo/openingLinks): All ways to open saved links
- [Browser selection](https://docs.supasidebar.com/howTo/browserSelection): Choose default and per-link browsers
- [Drag and drop](https://docs.supasidebar.com/howTo/dragAndDrop): Add files and folders from Finder
- [Browser import](https://docs.supasidebar.com/howTo/browserImport): Import bookmarks from Arc, Chrome, Brave, Edge, Vivaldi, Firefox, Safari, or an HTML file. Chromium and Firefox imports support a profile picker so each browser profile becomes its own SupaSidebar space
- [Smart Save and Smart Copy](https://docs.supasidebar.com/howTo/smart): Context-aware shortcuts that adapt to the frontmost app
- [Claim discount](https://docs.supasidebar.com/howTo/claimDiscount): Apply discounts at checkout

## Troubleshooting

- [Sidebar stays on top](https://docs.supasidebar.com/troubleshooting/sidebarStaysOnTop): Fix the sidebar always staying above other windows
- [Sidebar doesn't hide in browser](https://docs.supasidebar.com/troubleshooting/sidebarDoesntHideInBrowser): Fix auto-hide not triggering when a browser is focused
- [Link opens new tab instead of switching](https://docs.supasidebar.com/troubleshooting/linkOpensNewTab): Fix Smart Tab Reuse not activating the existing tab
- [MCP issues](https://docs.supasidebar.com/troubleshooting/mcp): Common Model Context Protocol problems and fixes