Cux

Claude Code account switcher for uninterrupted sessions.

   

   

   

   

cux is a CLI tool for Claude Code that pools multiple Pro/Max
accounts behind a single live session. When the active account hits
a rate limit, cux switches to a healthy account and continues the
same conversation. For proactive threshold swaps, it waits for the
current turn to finish first. No logout, no reload, no lost context.

Contents

- Install
  - Option 1 — npm
  - Option 2 — shell installer
  - Option 3 — manual binary
  - After install
  - What works on which platform
- Quick start
  - Verify your setup once
- How it works
- Daily usage
  - Watch & attach to running sessions
- Configuration
  - Strategies
- Swap history
- Data layout
- Security
- Building from source
- License
- Socials

Install

Three install methods. Pick the one that fits your platform — they
all install the same cux binary.

Option 1 — npm

Works on Linux, macOS and Windows. Requires Node.js 18 or newer.

Option 2 — shell installer

Works on Linux, macOS, WSL and Git Bash on Windows.

Option 3 — manual binary

Works everywhere. Useful if you don't want Node.js and can't run
shell scripts (e.g. native Windows PowerShell or cmd.exe).

1. Download the matching artefact from the
   releases page:
   - cux-linux-amd64, cux-linux-arm64
   - cux-darwin-amd64, cux-darwin-arm64
   - cux-windows-amd64.exe
2. On Linux/macOS, chmod +x cux-- and rename to cux.
3. Move it somewhere on your PATH:
   - Linux/macOS: ~/.local/bin/cux
   - Windows: any directory listed in your Path environment variable.

After install

Run cux setup once. That installs the /switch and /cux:* slash
commands plus the four Claude Code hooks. Restart Claude Code
afterwards so it picks them up.

What works on which platform

† On…