caam

Switch AI coding CLI accounts by backing up and restoring OAuth auth files.

3|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill caam-burningportra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caam
Source: https://github.com/burningportra/agent-flywheel-plugin/tree/main/skills/caam
Command: npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill caam-burningportra

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hitting rate limits on Claude Max, GPT Pro, or Gemini Ultra subscriptions forces a slow browser OAuth re-login (30-60 seconds) to switch accounts. CAAM backs up each account's auth files into a local vault and restores them in ~50ms, so you can rotate between accounts without browser logins. ## Core Features & Use Cases - Instant Account Switching: Back up and restore auth files for Claude Code, Codex CLI, and Gemini CLI with caam backup and caam activate. - Smart Rotation & Cooldowns: Automatically pick the healthiest profile with caam activate --auto, and mark rate-limited profiles with cooldowns so rotation skips them. - Isolated Profiles for Parallel Use: Run multiple accounts simultaneously in separate terminals or NTM panes using isolated $HOME directories via caam exec. - Use Case: You hit a Claude rate limit mid-session. Run caam cooldown set claude then caam activate claude --auto to switch to a healthy backup account in milliseconds and keep working. ## Quick Start Ask the agent to install CAAM, back up your current Claude account, and switch to a second saved account using caam activate.

Frequently Asked Questions about caam

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch Claude Code accounts without logging in again?

Back up each account's auth files with caam backup claude <email>, then restore any saved profile instantly with caam activate claude <email>. The switch takes about 50ms because it only copies files from the local vault, with no browser OAuth involved.

How to automatically fail over when hitting Claude or Codex rate limits?

Wrap your CLI calls with caam run, for example caam run claude -- "your prompt". When a rate limit is detected, it marks the current profile with a cooldown and retries with the next healthy profile selected by the rotation algorithm.

Which AI coding CLIs does CAAM support?

CAAM supports Claude Code (Claude Max), Codex CLI (GPT Pro), and Gemini CLI (Gemini Ultra). It manages each tool's auth files such as ~/.claude.json, ~/.codex/auth.json, and ~/.gemini/oauth_credentials.json.

Can I run multiple CLI accounts at the same time?

Yes, use isolated profiles instead of the vault. Create them with caam profile add, log in once per profile with caam login, then run accounts in parallel with caam exec, which gives each profile its own isolated HOME directory.

How does caam status know which account is active?

caam status uses content hashing: it SHA-256 hashes the current auth files and compares them against all vault profiles. A hash match identifies the active profile, so detection works even after manual switches or reboots.

Should I sync the CAAM vault across multiple machines?

No. Auth tokens often contain machine-specific identifiers like device IDs, so syncing the vault can break sessions. Back up and restore profiles separately on each machine instead.