Groups
Use groups to separate projects, teams, or contexts such as work and personal life.
Help for working with Biscuit every day
Biscuit is a browser for the apps you keep open all day. This guide focuses on how the app is actually built today: app groups, isolated sessions, notifications, saved passwords, downloads, cloud sync, and keyboard-first navigation.
1. Understand the workspace
Biscuit is organized around groups, apps, and tabs rather than one long strip of unrelated tabs. The sidebar holds your groups and apps, the tab bar shows tabs for the current app, and the main area shows the selected page.
Apps
Each app is a saved web app entry in the sidebar, with its own settings and session behavior.
Tabs
Links opened inside an app stay attached to that app, so related work stays together.
Tip: Biscuit works best when you keep app-like services here and leave general browsing to your default browser.
2. Add apps and groups
You can add a new tab, app, or group directly from the File menu. Apps can be picked from the app directory or added as a custom app by URL.
- Use
Cmd/Ctrl + Nto add a new app. - Use
Cmd/Ctrl + Gto add a new group. - Use the app directory when a service is supported, or paste a URL for a custom setup.
- Rename groups to match projects so switching contexts stays quick.
If you work across many clients or products, a group-per-project layout usually keeps Biscuit easy to scan and reduces notification overload.
3. Choose how sessions behave
By default, apps do not share sign-in state with each other. That helps you keep multiple accounts separate. If you want apps in the same group to behave like one shared browser profile, enable Shared Session for that group.
Default behavior
Each app keeps its own session, so signing into one app does not automatically sign in another.
Shared Session
Apps inside one group can share session state after you enable it and sign in again.
When to use it
Use it for tightly connected tools in one workspace. Keep it off when you need account isolation.
Important: turning Shared Session on asks you to log back into your apps. Biscuit warns about this in the product because the session model really changes.
4. Manage notifications
Biscuit can show unread state per app and lets you control notifications at both the app level and the whole app level. This is especially useful when one workspace needs alerts and another should stay quiet.
- Right-click an app to turn its notifications on or off.
- Use the global notification button to mute everything when you need focus time.
- Switch notification badges between a dot and a number in Settings.
- Some services expose custom unread logic, so counts can feel more app-aware than a normal browser tab.
5. Handle sign-in and permissions
Biscuit includes a few workflows that matter during daily sign-in: saving passwords, granting media access, and reviewing site permissions later from Settings.
Saved passwords
Biscuit can ask whether to save a username and password after a successful sign-in form submission, and you can review saved entries in Password Manager.
Camera and microphone
When a site requests media access, Biscuit asks before allowing it. Approved sites are listed in Settings so you can remove them later.
System permissions
If macOS blocks camera or microphone access, Biscuit points you to the relevant system privacy settings.
Security note: saved passwords, cookies, and sign-in state stay local to the device. They are not part of cloud sync.
6. Move data between devices
Biscuit has more than one way to preserve your setup. Choose the method that matches what you want to carry over.
- Backups: Biscuit keeps backups and can restore from the backup list.
- Import / Export: export your app and tab settings, then import them on another machine.
- Downloads: choose a download location and optionally ask where to save each file.
Import and export are great for structure. If you expect credentials and active sessions to follow you too, that is a different problem and not something the sync layer promises.
7. Know what cloud sync includes
Cloud sync is intentionally limited. It syncs top-level workspace structure and device-independent settings, not everything on the machine.
What sync includes
Top-level tab structure, notification settings, shortcut settings, and other device-independent workspace settings.
What sync excludes
Credentials, cookies, saved passwords, sign-in state, URLs in local child tabs, and other local-only state.
What happens on conflicts
If another device syncs first, Biscuit can restore the latest synced workspace and asks you to review before overwriting it again.
You can sign in with an email verification code, and in some builds with an existing email and password. Once signed in, cloud sync can turn on automatically.
8. Learn the fastest shortcuts
Biscuit has a built-in shortcut help dialog, but these are the ones that matter most when you want the app to feel fast.
Cmd/Ctrl + / Open shortcut help
Cmd/Ctrl + O Open app switcher
Ctrl + Tab Next app in switcher
Ctrl + Shift + Tab Previous app in switcher
Cmd/Ctrl + B Toggle sidebar
Cmd/Ctrl + L Focus address bar
Cmd/Ctrl + Alt + Down Select next app
Cmd/Ctrl + Alt + Right Select next tab
Number shortcuts can jump either to apps or tabs depending on your shortcut setting, so if a number shortcut behaves differently than expected, check Settings > Shortcuts.