account-switch (acsw)

Switch between Claude Code accounts without logging out. Minimal runtime dependencies.

Claude Code only supports one OAuth account at a time. This tool saves and restores credentials so you can switch instantly between personal, work, or team accounts.

Install

# pnpm
pnpm add -g @oakoss/account-switch

# npm
npm install -g @oakoss/account-switch

Or build from source:

git clone https://github.com/oakoss/account-switch
cd account-switch
pnpm install
pnpm build
cp dist/acsw ~/.local/bin/

Usage

Save your current session:

acsw add personal

Log into another account via Claude Code, then save it:

acsw add work

Switch between them:

acsw use personal
acsw use work

Or use the interactive picker:

acsw

Commands

| Command | Description | | -------------------------- | ----------------------------------- | | acsw | Interactive profile picker | | acsw add <name> | Save current session as a profile | | acsw use <name> | Switch to a profile | | acsw <name> | Shortcut for use | | acsw list (ls) | List all profiles | | acsw remove <name> (rm) | Remove a profile | | acsw current | Show active profile | | acsw repair | Validate and fix profiles | | acsw env | Shell integration for auto-switching | | acsw completions <shell> | Generate shell completions |

Shell completions

# Zsh: add to ~/.zshrc
eval "$(acsw completions zsh)"

# Bash: add to ~/.bashrc
eval "$(acsw completions bash)"

# Fish: save to completions directory
acsw completions fish > ~/.config/fish/completions/acsw.fish

Completions cover subcommands and profile names for use, remove, and bare acsw <profile>.

Auto-switch on cd

Automatically switch profiles when entering a project directory:

# Zsh: ~/.zshrc | Bash: ~/.bashrc
eval "$(acsw env --use-on-cd)"

# Fish: ~/.config/fish/conf.d/acsw.fish
acsw env --use-on-cd | source

Then create a .acswrc in your project root:

{ "profile": "work" }

Now when you cd into that directory, acsw switches to the work profile automatically.

How it works

• Swaps OAuth credentials (system keyring on macOS/Windows, ~/.claude/.credentials.json on Linux) and the oauthAccount field in ~/.claude.json
• Never touches settings.json, memory, plugins, or project config
• Saves the current profile back before switching (no stale tokens)
• Warns if Claude Code is running

Docs

See docs/ for architecture, usage guide, and design decisions.

Development

pnpm install
pnpm dev -- list           # run from source
pnpm test                  # run tests
pnpm typecheck             # typescript type checking
pnpm lint                  # oxlint
pnpm format:check          # oxfmt
pnpm lint:md               # markdownlint
pnpm build                 # compile standalone binary

License

MIT