Installation

At a glance

• Available on the Chrome Web Store and on Firefox Add-ons.
• Four permissions requested, all used locally (tabs, storage, notifications, scripting).
• Local build possible with pnpm install && pnpm build (or pnpm build:firefox).

Install from a store

Chrome / Edge / Brave

SmartTab Organizer on the Chrome Web Store. Compatible with every Chromium-based browser (Chrome, Edge, Brave, Vivaldi, Arc, Opera). On Vivaldi, automatic grouping is not available (Vivaldi does not expose Chromium’s tab groups API); deduplication and sessions still work.

1. Click Add to Chrome.
2. Accept the permissions in the browser dialog.
3. Pin the icon to the toolbar via the Extensions menu for quick access.

Firefox

SmartTab Organizer on Firefox Add-ons.

1. Click Add to Firefox.
2. Accept the permissions in the dialog.
3. The icon is pinned to the toolbar automatically.

Pin the extension to the toolbar

Pinning the icon to the toolbar keeps the popup one click away. On Chromium browsers, open the Extensions menu (the puzzle piece in the toolbar) and click the pin next to SmartTab Organizer. On Firefox, the icon is pinned automatically on install. Once pinned, the icon also shows the state badge for grouping and deduplication.

Permissions requested

The extension asks for four permissions, all used exclusively locally. None of them allows any network communication.

Permission	Why
tabs	Read tab URLs and titles to group them and detect duplicates.
storage	Persist your rules, sessions and settings in browser.storage.local.
notifications	Show grouping and deduplication notifications, with the Undo button.
scripting	Inject the content script that captures middle-clicks and right-clicks on links, to trigger grouping.

Caution

The extension does not request broad host permissions or webRequest. It cannot inspect network traffic and never reads page contents beyond the clicked links.

Install locally from the sources

To develop or test an unreleased version:

Chrome / Chromium

git clone https://github.com/EspritVorace/smart-tab-organizer.git
cd smart-tab-organizer
pnpm install
pnpm build

1. Open chrome://extensions in Chrome.
2. Toggle developer mode in the top right.
3. Click Load unpacked and pick the .output/chrome-mv3/ folder.

Firefox

git clone https://github.com/EspritVorace/smart-tab-organizer.git
cd smart-tab-organizer
pnpm install
pnpm build:firefox

1. Open about:debugging#/runtime/this-firefox.
2. Click Load Temporary Add-on.
3. Select the .output/firefox-mv2/manifest.json file.

Note

A temporary install in Firefox is lost when the browser closes. For permanent use from the sources, run pnpm zip:firefox and sign the .xpi.

First launch

Once the extension is installed:

1. Click the SmartTab Organizer icon in the toolbar. The popup opens empty, with no rule or session saved.
2. Click Open Options to open the full page. If some of your open tabs match a ready-made pack, the Home tab lists the matching packs (with the number of matching tabs each) and an Import and organize button. Otherwise it falls back to two generic actions: Create my first rule or Import a rules pack.
3. The pack analysis is fully local: your open tabs are read in the browser only, nothing leaves your machine. The suggestions stay until you create or import a rule.
4. After importing, an Organize now button rearranges your open tabs right away. See Categories and packs.

Next steps

Interface tourPopup and Options page in two minutes.

The home pageThe Options hub after onboarding.

Categories and packsImport a collection of rules in one click.