Install
TabCompass works in Google Chrome on macOS, Windows and Linux. Chrome keeps each profile's extensions separate, so install TabCompass in every profile you use. Without sync, each copy works on its own; with sync, they can all see each other's tabs.
chrome://extensions, turn on
Developer mode, choose Load unpacked, and select the
TabCompass folder.
First steps
- Click the TabCompass icon in the toolbar (pin it from the puzzle-piece menu if you don't see it).
- Open settings with the ⚙ button.
- Under This profile, give the profile a short label, such as "Work", and a color. They identify this profile's tabs in search results from your other profiles.
- Press Save settings.
The number on the toolbar icon is how many tabs in this profile are currently loaded in memory.
Search and shortcuts
Press ⌘⇧K on a Mac or Ctrl⇧K on Windows and Linux, and start typing. Search matches titles and addresses, including abbreviations and partial words, and ranks open tabs in this profile first, then tabs in your other profiles, then archived tabs.
| Key | What it does |
|---|---|
↑ ↓ |
Move through results |
↵ |
Switch to the tab. A tab in another profile on this computer brings that profile's window to the front; a tab on another computer opens here. |
⇧↵ |
Always open the page in this profile |
⌘⌫ / Ctrl+⌫ |
Close the selected tab, or delete it from the archive |
⌘K / Ctrl+K |
Keep the selected tab loaded (see Keep a tab loaded) |
⇥ |
Cycle the profile filter (All, each profile, Archive) |
Esc |
Close the search window |
To change the shortcut, open chrome://extensions/shortcuts, or use
Change keyboard shortcut in settings.
Unloading idle tabs
A tab you haven't used for the set time (30 minutes by default) is unloaded: Chrome frees its memory, but the tab stays in your tab strip with its title and icon, and reloads when you click it. An unloaded tab runs no scripts or timers.
These tabs are never unloaded:
- the active tab in each window
- tabs playing audio
- pinned tabs (unless you turn off Never unload or archive pinned tabs)
- sites on your exclude list, including their subdomains
- tabs you chose to keep loaded
- browser pages such as
chrome://settings
You can check which tabs are unloaded in chrome://discards.
Keep a tab loaded
In the search window, point at a tab and click the clock button, or select it and press ⌘K. Choose how long:
- For 1 hour or for 2 hours: good for an article you mean to come back to. When the time is up, the tab follows the normal rules again, so if you haven't used it, it is unloaded at the next check.
- Until I close it: the tab stays loaded until you close it or restart Chrome.
- Always keep site loaded: adds the site to the exclude list in settings, which lasts across restarts. Use this for email or chat.
A kept tab is also never archived, and Chrome's own Memory Saver leaves it alone. The search window shows kept loaded and the time left under its title.
Tidy up and collections
Tidy up clears your tabs out of Chrome and keeps them in TabCompass, sorted into named collections, so your windows are clean and nothing is lost. Click Tidy up at the top of the search popup.
-
TabCompass shows a preview before anything closes:
- tabs in a Chrome tab group go into a collection named after the group;
- with the AI assistant on, other tabs are sorted by topic ("Trip to Lisbon", "Q4 hiring");
- otherwise they're sorted by site, using your group rules;
- sites with a single tab go into Other.
- Rename a collection by clicking its name, move a tab with Move to…, or untick a tab to leave it open.
- Choose all windows or only this window. Pinned tabs, tabs playing audio, kept-loaded tabs and never-unload sites stay open unless you untick them. Browser pages (settings, extensions) always stay open, and blank New Tab pages are simply closed.
- Click Put away. Each tab is saved first, then closed; windows left empty close too. Undo reopens everything from that tidy.
To put away just one tab, right-click it in Chrome's tab strip and choose Save to collection (Chrome 150 or later). The tab is saved and closes. Pick one of your recent collections, or Sort automatically: a tab you reopened goes back to where it came from, and any other tab is sorted by its tab group or site. If several tabs are selected, they're all saved.
On the Collections page:
- Click a tab to open it again. It leaves the collection, because it's open again. To put it back, right-click the tab and choose Save to collection.
- Open all opens a collection in a new window as a Chrome tab group. Only the first tab loads; the others load when you click them.
- Rename or Delete a collection. Renaming it to the name of another collection merges the two.
- Tabs archived automatically are listed under Archived automatically. Organize sorts them into collections the same way.
- Search finds saved tabs by title, address or collection name, and shows which collection each one is in.
If a page you put away is already saved, it moves to the new collection instead of being saved twice. Collections are part of the archive: they stay on your computer, and with sync on they're shared end-to-end encrypted with your other profiles.
The archive
Archiving saves a stale tab to TabCompass and closes it. It's off by default. When you turn it on, settings show how many open tabs would be archived right now, and ask you to confirm before anything closes. A tab is always saved before it is closed.
- Tabs in tab groups you made are kept out of the archive unless you turn off Never archive tabs in tab groups you made. The groups TabCompass makes by site don't count, so archiving keeps working with automatic grouping on.
- After a browser restart, tabs whose last use Chrome doesn't report count as just used, so a restart never triggers a mass archive.
- Find archived tabs with the search shortcut, on the Collections page, or in the archive list on the settings page. Restoring one that's already open switches to it instead of opening a copy.
- Export JSON downloads the whole archive.
Duplicate tabs
When two tabs show the same page, the popup offers Close duplicates, and search results with a copy are tagged "duplicate". TabCompass keeps the active, pinned or most recently used copy and closes the others.
Addresses are compared after removing tracking parameters such as utm_source,
fbclid and gclid. The part after # is kept, because
apps like Gmail use it to identify a specific email.
Tab groups
TabCompass can put each site's tabs into a Chrome tab group named after the site, with the same colour every time.
- Group in the search window (or Group tabs now in settings) groups every window: any site with 2 or more ungrouped tabs in a window gets a group.
- Group new tabs by site automatically (Settings → Tab groups, off by default) puts a tab into its site's group when it opens or moves to another site.
-
Sites that share a group: one rule per line, like
Work: atlassian.net, slack.com. Subdomains are included. - TabCompass only uses groups it made. It never moves tabs that are already in your own groups, pinned tabs, or excluded sites. Rename one of its groups and it becomes yours. A tab you drag out of a group isn't pulled back in unless it opens another page.
- Remove TabCompass groups in settings ungroups them; the tabs stay open.
Sync profiles and computers
Sync lets every TabCompass see the open tabs of all your other profiles, on this computer and your others, and share one archive. It's optional and set up per profile: a profile you don't sign in shares nothing.
Set up the first profile
- Settings → Sync: enter your email and choose Email me a sign-in link.
- Open the email on any device. Check that the code on the page matches the one TabCompass shows, then press Confirm. Opening the link alone does nothing.
- Choose an encryption passphrase of at least 12 characters. It encrypts everything before it leaves your computer.
- Name this computer, for example "MacBook".
Add your other profiles
In each other profile, sign in with the same email and enter the same passphrase. Use the same computer name for every profile on one computer: that's how TabCompass knows it can switch straight to their tabs rather than opening a copy.
Managing sync
- Other profiles lists every synced profile. Remove stops one from syncing.
- Change passphrase re-encrypts the key; your other profiles keep working.
- Forgot your passphrase? Choose Reset on the unlock screen. Synced data on the server is deleted and you start fresh; local tabs and this profile's archive are kept.
- Sign out of sync forgets synced data in this profile. Delete sync account deletes everything stored for you on the server.
- Offline? Search still shows results from the last sync, and changes you make are sent when you're back online.
Insights
Open Insights from the search window or from settings.
- Memory saved (estimate) is unloaded tabs × a per-tab figure. The figure starts at 80 MB and, once there are 5 measurements, follows your own measurements.
- Measured RAM freed is how much your computer's available memory rose between just before and a few seconds after TabCompass unloaded tabs. It's real but system-wide, so other apps can make it noisy.
- Unload idle tabs now unloads every tab that can be unloaded and shows how much memory it freed. Available memory going up is the good direction.
- Duplicates, tabs unused for 7 days or more, your busiest and most revisited sites, the order tabs were opened in (nested under the tab that opened them), and 14 days of activity.
Opening order, revisits and trends come from a local tab history kept in this profile for 30 days. Turn it off under Settings → Insights, which also deletes it, or use Clear history on the Insights page. After a browser restart, open tabs are listed as "restored", because Chrome gives them new identities.
Time
Switch the top of the Insights page from Tabs to Time to see where your time goes:
- Focused time today and in the last 7 days, how many times you switched tabs today, and your longest stretch on one site.
- Where your time goes: your sites and pages ranked by time, for a day, a week, a month or a year, compared with the same length of time before.
- When you browse: a weekday × hour map. Pick a site to see when you usually use it.
- Over time: time per hour, day or week.
- You switch a lot between: pages you go back and forth between, with Group them and Keep both loaded.
- Open but unused: open tabs you spent under a minute on in the last 7 days, with Put away to save them into collections. It starts after a week of tracking.
Time counts while a Chrome window is in front, for its active tab, and pauses after 2 minutes without mouse or keyboard input, unless the tab is playing sound. Incognito windows and browser pages aren't counted. Details per page are kept 30 days, and hourly totals per site for a year, in this profile only. The same tab history setting turns it on and off.
All profiles
With sync on, switch the top of the Insights page to All profiles to see every synced profile, on this computer and others, in one place:
- Total tabs, unloaded tabs and estimated memory saved across profiles.
- Each profile with its computer, tab counts and when it last updated.
- Pages open in more than one profile, tabs unused for 7 days or more, and your busiest sites.
- 14 days of activity added up across profiles.
Click a tab to switch to it in its profile, or open it here if that profile isn't running. A profile that hasn't updated for a day is listed but left out of the totals. Activity comes from profiles running TabCompass 0.6 or later with tab history on: they share daily counts only, inside their encrypted sync data, never which pages you visited.
AI assistant (optional)
With your own API key, TabCompass can suggest topic groups and help tidy old tabs. It works with GLM 5.3 from Z.ai by default, or any OpenAI-compatible API (including a model running on your own computer).
- Get an API key from your provider (for GLM: z.ai → API keys).
- In Settings → AI assistant, turn it on, paste the key and click Save AI settings. Chrome asks to let TabCompass contact that provider; allow it. Test connection checks the key.
- Tidy up sorts the tabs you put away by topic (see Tidy up and collections).
- On the Insights page, use Suggest topic groups (groups tabs by what they're about, across sites) or Review unused tabs (suggests archiving, closing or keeping each tab unused for 7+ days, with a reason).
- Untick anything you disagree with, then apply. Nothing changes before that.
- What was I doing? on the Insights page gives a short recap of each open window, or of the tabs you opened today (needs tab history). The last recap is kept on this computer until you refresh it.
-
Ask your tabs: in the search window, type
?and a description, like?that article about slow Postgres queries, then press ↵. It finds tabs by meaning, not just matching words, among the tabs listed (this profile, other profiles and the archive).
What's sent: tab titles and site names only, never full addresses or page contents, and nothing from excluded sites. It goes straight from your browser to the provider, only when you click. The key stays in this profile and isn't synced. A request with 300 tabs costs about one or two cents with GLM 5.3. Settings shows the tokens used this month.
Settings reference
| Setting | Default | Range |
|---|---|---|
| Unload idle tabs after | 30 minutes, on | 1 minute to 7 days |
| Archive tabs after | 7 days, off | 0 to 365 days |
| Never unload or archive pinned tabs | On | |
| Never archive tabs in tab groups you made | On | |
| Group new tabs by site automatically | Off | |
| Sites that share a group | None | Up to 20 rules, 20 sites each |
| Excluded sites | None | Up to 200 |
| Record tab history and time spent for Insights | On | Details 30 days, hourly totals per site 1 year |
Settings follow your Chrome profile through Chrome's own sync.
Troubleshooting
The sign-in email didn't arrive
Check spam and wait a minute. Links expire after 15 minutes, and at most 5 sign-in emails are sent per address per hour. If it still doesn't come, write to support@tabcompass.com.
Sync stays on "Connecting…"
Check your internet connection, then reload TabCompass in chrome://extensions. If
it continues, open chrome://extensions, choose service worker
under TabCompass, and send the error lines from the Console to support. Please don't include
lines that show your session token.
Enter opened a copy instead of switching
That profile probably isn't running, or uses a different computer name. Open a window of that profile, and make sure every profile on this computer uses exactly the same computer name.
A tab I was typing in reloaded
It was unloaded while idle. Add the site to the exclude list in settings.
Self-hosting sync
The sync server is open source and runs as one small Docker container (about 20 MB of memory) with a data folder for each account's encrypted database. You need a Linux server with Docker, a domain with HTTPS in front (for example nginx with Let's Encrypt), and an email provider for sign-in links (Brevo is supported).
-
Build the bundle (
pnpm build:selfhostinserver/) and copy theserver/selfhost/folder to the server. -
Create
.envfrom.env.example: a long randomACCOUNT_HMAC_SECRET, your public address, the email sender and the Brevo key. -
Create
data/owned by user id 10001, then rundocker compose up -d --build. -
Proxy your domain to
127.0.0.1:3020with WebSocket support, and log paths without query strings. - In each profile, enter your server's address under Sync → Advanced before signing in.
The full instructions are in the project README.