Account Switcher

Windows desktop plugin that switches which Codex login and which Claude subscription account every local Hermes profile uses, with one idle-only, verified restart of the gateway (and, on Hermes before 0.22, of Hermes Desktop). Refuses while any profile is busy, restores the previous selection if a step fails, and writes a receipt that says whether the switch took effect.

Good to know before installing

Windows only. A switch rewrites, through Hermes's own commands, the Codex credential order in every profile's auth.json and the CLAUDE_SUBSCRIPTION_DIRECTSDK_CONFIG_DIR line in every profile's .env, so every profile that has the plugin enabled spends the same selected Codex login and the same Claude login (one Hermes-owned claude-auth folder; no token is copied between profiles). It reads Codex tokens from each profile's auth.json. On Hermes 0.22 and later it stops and restarts the gateway once Hermes's own idle proof and the gateway's drain report idle, and Hermes Desktop stays open and reconnects; on earlier Hermes it also reads the Desktop backends' dashboard session token from their process environment and closes and reopens Hermes Desktop (work started in the seconds after the idle check is cut off). It sends the target Codex token to OpenAI's usage endpoint and Claude login tokens to Anthropic's OAuth profile endpoint (also when the setup screen opens); if the target Claude login has expired it first runs the claude CLI once so the CLI renews its own token, which rotates that login's refresh token. No telemetry and no automatic account rotation.

From the plugin's catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install account-switcher
  2. Said no? Turn it on later:
    hermes plugins enable account-switcher
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
AI models & providers · Hermes Desktop add-ons
Maintained by
SmelterLabs (Community)
Needs
No API keys declared
Works on
windows
Needs Hermes
0.21.6 or newer
Version
1.3.2
In the catalog
2026-10-20

Full setup & settings ↗Source code ↗

More in ai models & providers

All ai models & providers plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins