Troubleshooting
Solutions to common issues.
Sidebar Stays on Top
Sidebar blocks other apps when switching away from the browser
Sidebar Doesn't Hide in Browser
Sidebar auto-hides in other apps but stays visible in browsers
Sidebar Appears Automatically
The panel pops up on its own when you open a browser - turn off Auto-show with Browser
Prevent Overlap Isn't Working
Browser windows ignore Prevent Overlap because another app like HazeOver is managing windows too
Save shortcut or sidebar attach not working
When Cmd Shift S, Cmd Shift C, or Smart Attach silently fails, reset Accessibility and Automation
MCP Setup Issues
Tools not appearing, can't connect to SupaSidebar, npx not found, Codex shows fewer tools than expected
License Issues
Reactivate after a reinstall, move your license to a new Mac, fix common activation errors
Browser Profiles
Profile not detected, wrong browser launches, missing space switch prompt, Live Tabs showing the wrong tabs
Missing Browser Profiles
Chrome, Brave, or Edge only shows some of your profiles - diagnose whether it's a browser or SupaSidebar issue