Skip to content

claude-acc-manager (cam)

Linux-only CLI/TUI to manage, measure, and swap Claude Code OAuth subscription accounts.

cam keeps a registry of Claude Code logins, measures each account's quota usage against Anthropic's OAuth usage endpoint, and swaps the live claude login to the account with the most headroom, on demand or unattended via a polling loop. Credentials live as 0600/0700 files under XDG paths with atomic writes and proper-lockfile-compatible mkdir locks.

cam work   ● active 5h     ━━━━━━━━━━━━━━━━━━━━━╸─────┃──  73%  resets 20725d 8h · Oct 10 22:30 7d     ━━━━━━━━━━━━───────────────┃──  41%  resets 20730d 10h · Oct 16 00:00 Sonnet ━━━━━━━━━━━━━━━━━━━━━━━━━━─┃──  88%  resets 20730d 10h · Oct 16 00:00  (ahead of pace) personal5h 12% · 7d 8% backup5h 94% · 7d 87% (ahead) ────────────────────────────────────────────────────────────────────────────────────────────────────────────── menu █s  Switch account… █w  Watch accounts █g  Auto-switch view █e  Enable / disable account… █r  Remove account… █t  Theme… █c  Settings… █q  Quit  s Switch accounts  q Quit  f1 Help  ^t Theme  p Emails ▏^space

Where to start

  • Getting started: install cam, register your first account, and open the dashboard.
  • Guides: task recipes for switching strategies, the auto loop, --json scripting, and diagnostics.
  • Reference: the command-by-command CLI surface, the schema-v1 JSON contract, settings.json keys, and environment variables.
  • Internals: why the system is shaped this way, in the arc42 architecture document and the ADR record.

What cam is not

OAuth subscription accounts only; API-key and setup-token accounts are out of scope. Linux only; there is no macOS keychain, menubar, or Claude Desktop integration. The full scope list lives in architecture.md §11.