Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Account Rotation (Agent Credential Switch)

Switches a coding agent's account only on explicit request, then verifies the new identity by asking the runtime itself instead of diffing credential files.

UtilitiesIntermediate★ 445⑂ 41AI score 6/10Last updated: Sep 24, 2026

What it does

  • Performs an account/profile switch only when the caller explicitly asks; auto-rotating to dodge a quota is forbidden.
  • Routes to the right credential tool by host and agent family: macOS + Claude → claude-acct (Keychain-backed); file-backed Codex/Gemini/Linux/WSL → caam.
  • Confirms the switch by asking the target runtime who it is now — never by comparing credential-file bytes.
  • Names the key failure mode ("stale-process identity"): running processes still hold the old tokens in memory, so it reports partial rotation and whether a fresh process is required.
  • Returns a full report: host, agent family, tool used, requested account, identity before/after, any runtime still holding the old account, and the command exit code.

Who it's for

  • Developers juggling multiple accounts (personal/work) across Claude Code, Codex CLI, or Gemini CLI.
  • Operators standardizing the verification step of account switches in agent pipelines.
  • Anyone who has hit "I switched accounts but the agent still runs as the old one".

Examples

  1. "Switch to my work account" on macOS + Claude → uses the claude-acct route, then queries the runtime and reports before/after identity.
  2. Rotating Gemini credentials on a Linux box → uses caam, and flags live sessions still holding the previous account as a partial rotation.
  3. No credential tool or identity probe available → discloses the absence and stops, rather than claiming success from file diffs.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/boshu2/agentops/HEAD/images/gemini/skills/account-rotation/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the images/gemini/skills/account-rotation folder from the GitHub repo boshu2/agentops into my ~/.claude/skills/account-rotation/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/boshu2/agentops.git && mkdir -p ~/.claude/skills && cp -r agentops/images/gemini/skills/account-rotation ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal.
  2. Clone the repo: git clone https://github.com/boshu2/agentops.git
  3. Create the skills directory: mkdir -p ~/.claude/skills
  4. Copy the skill: cp -r agentops/images/gemini/skills/account-rotation ~/.claude/skills/
  5. Edit ~/.claude/skills/account-rotation/SKILL.md and replace claude-acct / caam with the account-switch commands that actually exist on your machine — those tools are the original operator's routes, not shipped here.
  6. Restart Claude Code and try: "use the account-rotation skill to switch accounts".
View source on GitHub ↗License: Apache-2.0