Fast User Switching

A SillyTavern extension for multi-user installs. It adds a button to SillyTavern's top bar, right after the native Character Management icon, showing the avatar of the currently logged-in account. Click it to pop up a picker of every other enabled login user; click one to switch to that account.

The button hides itself automatically when there's nobody to switch to: when SillyTavern's multi-user accounts feature (enableUserAccounts in config.yaml) is off entirely, when every other account has been filtered out, or when the server is running in "discreet login" mode where the account list can't be shown. When accounts are off, the extension's settings panel shows a warning explaining why the button is missing.

How switching works

Picking a user calls SillyTavern's own login endpoint with that account's handle. If the account has no password, you're switched immediately. If it has one, a small popup asks for it first. Either way, a page reload follows — SillyTavern's client-side state (chat, settings, characters, personas) is all tied to the previous session, so a full reload is required to load the new one cleanly, the same as using the native login page.

Settings

Settings live under Extensions → Fast User Switching in the Extensions panel.

• Hide Current User (default: on) — when enabled, the account you're currently logged in as is left out of the picker (there'd be nothing to do by clicking it). Turn it off to see yourself listed too, e.g. to confirm which account is active.
• Dim Avatar Images (default: off) — when enabled, every entry in the picker is shown at half opacity; leave it off for full-brightness avatars/rows.
• Display Mode (default: Avatars) — controls how the picker is laid out:
  • Avatars — a grid of circular avatars.
  • List — a vertical list of user names, each with a small inline avatar to the left.

Manual installation

1. Clone this repository:

   git clone <this-repo-url> STFastUserSwitching
   cd STFastUserSwitching

2. Copy it into your SillyTavern install using the included script, passing the path to your SillyTavern root (the folder that contains public/):

   ./install.sh /path/to/SillyTavern

   This copies manifest.json, index.js, style.css, and settings.html into:

   /path/to/SillyTavern/public/scripts/extensions/third-party/STFastUserSwitching/
   

   To update after pulling changes, just re-run the same command — it overwrites the installed copy.

   Without the script: create the destination folder yourself and copy the same four files into it:

   mkdir -p /path/to/SillyTavern/public/scripts/extensions/third-party/STFastUserSwitching
   cp manifest.json index.js style.css settings.html \
     /path/to/SillyTavern/public/scripts/extensions/third-party/STFastUserSwitching/

Reloading SillyTavern

No server restart is required, either for the initial install or for picking up updates — SillyTavern discovers extensions live on every page load. Just reload the SillyTavern tab in your browser.

If you re-installed an update and don't see the change take effect, do a hard refresh (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows/Linux) to bypass the browser's cache of the extension's JS file.

License

MIT