Per-agent Claude and Codex accounts with account-wide quota monitoring
Supported platforms: macOS, Linux.
npmjs · Paseo 0.9+
paseo plugin add npm:paseo-plugin-account-switcher@0.3.4GitHub · Paseo 0.8 fallback
paseo plugin add dutchakdev/paseo-plugin-account-switcher --ref 3aea532c8306b00f4a6a57759a527564ba997762Git security status and fallback installation are pinned to commit 3aea532c8306.
From the plugin's README
Paseo plugins are trusted, unsandboxed code with the daemon user's access to files, processes, credentials, and network. Account Switcher reads your Claude and Codex sign-ins to identify accounts and check their limits, and it sends no model messages. The commands below target the local daemon; for another host, see remote daemons.
On Paseo 0.11.0 or a later release, including 0.12 and 0.13, install the reviewed version from the plugin directory:
paseo plugin add dutchakdev/account-switcher
On Paseo 0.9 and 0.10, and on the 0.11.0 betas, install from npm. On 0.11 and later, npm also gets a new version before the directory approves it:
paseo plugin install npm:paseo-plugin-account-switcher
On Paseo 0.8, install from GitHub. Paseo then runs the manifest's dependency and build steps on the daemon:
paseo plugin install dutchakdev/paseo-plugin-account-switcher
To review or change the source first, install a local checkout.
README
Use several Claude and ChatGPT/Codex subscription accounts in Paseo. Choose an account for each agent, switch the account of an existing chat, and see the limits of every saved account.
Listed in the Paseo plugin directory and on paseo.cafe.
The interface is in English. Reset dates use the viewing device's local time zone. See installation for remote hosts and verification for the scope of recorded testing.
Paseo plugins are trusted, unsandboxed code with the daemon user's access to files, processes, credentials, and network. Account Switcher reads your Claude and Codex sign-ins to identify accounts and check their limits, and it sends no model messages. The commands below target the local daemon; for another host, see remote daemons.
On Paseo 0.11.0 or a later release, including 0.12 and 0.13, install the reviewed version from the plugin directory:
paseo plugin add dutchakdev/account-switcher
On Paseo 0.9 and 0.10, and on the 0.11.0 betas, install from npm. On 0.11 and later, npm also gets a new version before the directory approves it:
paseo plugin install npm:paseo-plugin-account-switcher
On Paseo 0.8, install from GitHub. Paseo then runs the manifest's dependency and build steps on the daemon:
paseo plugin install dutchakdev/paseo-plugin-account-switcher
To review or change the source first, install a local checkout.
paseo plugin ls account-switcher shows running, then open Accounts in the sidebar or Accounts and limits in the Command Center.Select Add, choose a provider, name the account, and select Add and sign in. The official CLI runs in the background; the plugin opens a sign-in dialog without creating a terminal or workspace.
| Where you use Paseo | How to open sign-in |
|---|---|
| Desktop app | The dialog tries to copy the link. Paste it into your usual browser; Copy link retries copying. |
| Web or native mobile client | The dialog tries to open the browser. Open browser and Copy link remain available. |
If clipboard access is unavailable, expand Show sign-in link and copy its selectable text.
#, into Authorization code and select Finish sign-in.After sign-in, the plugin verifies the account and refreshes its limits. To check again, use Check sign-in in the account's ⋯ menu. Enter passwords only on the provider's official page.
Closing the dialog leaves Continue sign-in on the account. Cancel sign-in stops the process before releasing the profile. While sign-in is active, the account cannot be applied, made the default, or deleted. A failed start leaves the account available for Retry sign-in without creating a duplicate. Plugin reloads stop pending sign-ins; start again afterward.
The ⋯ menu contains refresh, check sign-in, default, sign-in, rename, and remove actions. Account rows show identity, default status, and counts of current and pending agents.
Before signing in again, switch agents away from that profile. To remove a managed account, clear its default and all current or pending selections first. Removal asks for confirmation. Archived agents retain their account binding for resume; restore and switch them before removing the account. Current CLI accounts cannot be removed.
You can select an account during a response, but it is never applied automatically. Cancel selection clears it. All accounts opens the full account list.
Apply reloads the agent through Paseo while preserving its native session ID. The plugin confirms the new account only after startup confirmation and successful reload. If a switch fails, it attempts to restore the previous account. Account not confirmed means the running account could not be established; select an account and apply again.
Different agents can use different accounts in parallel. Avoid sending from another client during Apply: Paseo's native reload has no atomic lock against a concurrent message, which could be interrupted.
Each account shows all reported limit windows, including zero usage. Measured windows show used and remaining percentages and a reset countdown. Expand details for exact local reset times, durations, fetch/check timestamps, and windows without data.
Monitoring sends no model messages. The official CLIs own authentication and token refresh; a native Codex limits request may refresh its token. See monitor details for scheduling, identity verification, and cache behavior.
Plugin directory, npm, and Git installations update with paseo plugin update account-switcher, which shows the new revision and asks for approval.
Before disabling or removing the plugin, select Disable in Accounts to restore the original provider commands. Removal does not delete the separately stored account data. See update and removal for a local checkout, the full steps, and recovery.
This project supports manual, same-provider switching with subscription accounts. Automatic account rotation, API-key authentication, and Claude-to-Codex transfers are outside its scope. Provider authentication and limit formats can change with CLI versions; unsupported data is shown as unavailable.
Automated tests cover the implementation with synthetic accounts and provider responses. They do not establish real A → B → A switching, compaction, child-session behavior, or rewind for your accounts. Recorded checks and remaining live verification are in verification.
Licensed under the MIT License. See third-party notices for bundled dependencies.
Scanned 22 Oct 2026, 13:36 UTC from dutchakdev/paseo-plugin-account-switcher.