wrangler-accounts

Local CLI to manage multiple Cloudflare Wrangler login profiles by saving and swapping the Wrangler config file.

What it does

• Save the current Wrangler config as a named profile
• Switch between profiles by copying a saved config into place
• List or inspect status (active profile and matching profile)
• Optional automatic backups when switching

Install (npm)

npm i -g @leeguoo/wrangler-accounts

Install (local)

From this repo:

npm link

Or run directly:

node bin/wrangler-accounts.js <command>

Usage

wrangler-accounts list
wrangler-accounts status
wrangler-accounts login work
wrangler-accounts save work
wrangler-accounts use personal
wrangler-accounts remove old

Options

-c, --config <path>     Wrangler config path
-p, --profiles <path>   Profiles directory
--json                  JSON output for all commands
--plain                 Plain output for list (one name per line)
-f, --force             Overwrite existing profile on save
--backup                Backup current config on use (default)
--no-backup             Disable backup on use

Environment variables

• WRANGLER_CONFIG_PATH
• WRANGLER_ACCOUNTS_DIR
• XDG_CONFIG_HOME

JSON output

Use --json for machine-readable output.

Examples:

wrangler-accounts list --json
wrangler-accounts status --json
wrangler-accounts use personal --json

Defaults

If you do not specify a config path, the CLI checks for these and uses the first existing path:

• ~/.wrangler/config/default.toml
• ~/Library/Preferences/.wrangler/config/default.toml
• ~/.config/.wrangler/config/default.toml
• ~/.config/wrangler/config/default.toml

The profiles directory defaults to:

• $XDG_CONFIG_HOME/wrangler-accounts (if set)
• ~/.config/wrangler-accounts

Notes

• Profile names accept only letters, numbers, dot, underscore, and dash.
• On use, the current config is backed up into __backup-YYYYMMDD-HHMMSS unless you pass --no-backup.
• login <name> overwrites an existing profile with the same name.

Discoverability (SEO / GEO / AI search)

This project is a Cloudflare Wrangler multi-account switcher for global teams. Keywords: Cloudflare Workers account manager, Wrangler login profiles, multi-account, account switcher, geo-distributed ops, AI search indexing.

Shell completion (zsh)

mkdir -p ~/.zsh/completions
cp $(pnpm root -g)/@leeguoo/wrangler-accounts/completions/wrangler-accounts.zsh ~/.zsh/completions/_wrangler-accounts

Then add to your ~/.zshrc:

fpath=(~/.zsh/completions $fpath)
autoload -Uz compinit && compinit