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.

$ cux
cux: rate limit on alice@example.com → swapped to bob@example.com, resuming…
> What number did I tell you to remember?
4729.

---

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.

npm install -g @inulute/cux

Option 2 — shell installer

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

curl -fsSL https://raw.githubusercontent.com/inulute/cux/main/scripts/install.sh | sh

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-<os>- 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

	Linux	macOS	WSL / Git Bash	native Windows
Account commands (add, list, switch, status, …)	✅	✅	✅	✅
Credential storage	file (0600)	Keychain	file (0600)	Credential Manager
Hooks + /switch and /cux:* slash commands	✅	✅	✅	✅
Auto-resume on swap	✅	✅	✅	✅ †
npm install -g @inulute/cux	✅	✅	✅	✅
curl … | sh shell installer	✅	✅	✅	❌
Manual binary download	✅	✅	✅	✅

† On native Windows the wrapper hard-terminates claude on swap (Go can't send SIGINT cross-process there). The Stop hook still flushes the transcript before the wrapper acts, so the resumed conversation is intact — but if you see anything unexpected, please open an issue.

Quick start

Website: https://cux.inulute.com