Clawscummer
When you're power-using Claude Code and Gemini for hours at a time, rate limits are the enemy. Clawscummer is the session manager that makes them irrelevant.
It watches multiple accounts in parallel and rotates between them automatically the moment a limit is hit — preserving context, continuing the task, and keeping you in flow. It also layers in a Plan-Execute pipeline where Gemini plans and Claude executes, and a cross-CLI handoff system so no context is ever lost when switching models or accounts.
Cross-platform Textual TUI · Windows / Linux / macOS · Standalone binaries via PyInstaller · MIT with Commons Clause
The Problem it Solves
Claude and Gemini APIs have per-account rate limits. When you're running long autonomous coding sessions — the kind where Claude Code is rewriting files, running tests, and fixing bugs for 45 minutes straight — hitting a limit mid-task means manually switching accounts, re-setting context, and losing flow.
Clawscummer treats your collection of accounts as a pool and manages rotation automatically. It also integrates a structured planning layer (Gemini) with an execution layer (Claude), so complex multi-step tasks get proper decomposition before any code gets written.
Quick Start
Install from source
bash install.sh.\install.ps1Or download a standalone binary from Releases
Requirements: Claude Code and/or Gemini CLI on PATH · Python 3.8+
Workflow Modes
Features
Auto Account Rotation
Monitors for rate limit signals in real time and silently rotates to the next account the moment one is hit. The conversation never drops — it keeps going on a fresh account without you noticing.
Session Browser
A full browsable interface for all past conversations across every account. Search by keyword, filter by model, resume any session with keyboard shortcuts 1/2/3 for the three most recent. Nothing gets lost when you rotate accounts.
Plan-Execute Pipeline
Gemini handles planning: it breaks complex tasks into structured step sequences. Claude handles execution: it works through each step using Claude Code. Two models playing to their strengths. Switch modes live with the m key.
Cross-CLI Handoff
When a session moves to a new account, an automatic context summary is generated and injected into the new session. The incoming Claude picks up exactly where the previous one left off — same task, same context, no re-explaining.
AGENTS.md Scanner
Scans the working directory tree for AGENTS.md instruction files and injects their contents into the session context on start. Your project-level AI instructions are always active, no manual copy-paste.
Cross-Platform Textual TUI
Runs in the terminal on Windows, Linux, and macOS via Textual. Sessions list and accounts list side by side — Enter to launch, R to resume, click an account to switch. After a CLI session exits, it detects rate limits and offers to auto-switch and continue on the next account.
Multi-account Credential Vault
Stores API keys and session tokens for multiple Claude and Gemini accounts. Rotation order is configurable — prioritize by remaining quota, by model version, or round-robin. Switch account mid-session with Ctrl+Shift+S.
GitHub Actions CI
Automated build pipeline produces clawscummer-windows.exe, clawscummer-linux, and clawscummer-macos binaries on every tagged release via PyInstaller + GitHub Actions. Download and run, no setup.
Keyboard Shortcuts
Build
CI builds all three platform binaries automatically on every tag push. To build locally:
bash build.sh.\build.ps1