1Install
Chrome only lets you install extensions from outside the Web Store by hand. It takes about a minute.
- Download the zip with the button above.
-
Unzip it into a folder you'll keep, for example
~/chrome-extensions/claude-switcher. Chrome loads the extension from this folder every time it starts, so don't delete or move it. - Open in a new tab and turn on Developer mode (top right).
-
Click Load unpacked and select the unzipped folder (the one that
contains
manifest.json). - Pin it: click the puzzle icon in the toolbar, then the pin next to Claude Multi-Session Switcher.
2Update
The extension checks this page and shows "Version X is available" in its popup when a new build is out.
- Download the new zip from this page.
- Unzip it over the same folder you installed from, replacing all files.
-
In
chrome://extensions, click the reload icon on the extension's card. Your saved profiles stay.
Good to know
- Never click "Log out" inside claude.ai. It ends that saved session for good. Use Detach from the profile's menu in the extension instead.
- If Chrome asks to "Disable developer mode extensions" on startup, choose Cancel to keep it.
- Export files (Settings → Export) contain live login tokens. Treat them like passwords.
Changelog
What changed in each release.
0.2.5 (2026-11-10)
Features
- signed managed (JAMF) build with its own extension ID (#16) (be97008)
0.2.4 (2026-10-31)
Features
- site: show CHANGELOG.md in a changelog section on the install page (#15) (743420c)
0.2.3 (2026-10-31)
Features
- 3-letter profile short names and email-domain default names (#14) (62f4ffa)
0.2.2 (2026-10-20)
Features
- drag and drop to reorder profiles in the popup (#11) (12d416c)
Bug Fixes
- harden profile reordering (review findings) (#13) (65b95e6)
- tint: tint the hover-revealed sidebar peek popover (#12) (2aa2bc6), references #frame-peek-popover
0.2.1 (2026-10-20)
0.2.0 (2026-10-20)
Features
- automate version bump from conventional commits on release (#7) (22857d4)
- Distribute via public GitHub Pages with in-extension update notice (#2) (699be65)
Bug Fixes
- Apply profile colour changes to open claude.ai tabs live, tint settings console nav (#6) (02d6e97)
- Show extension logo in popup header, bump to 0.2.0 (#5) (7d152b3)
- Worktree replace logo (#1) (5ac810c)