Skip to main content

​
Account Safety

Automatic protections to prevent Google account bans when using multiple OAuth providers simultaneously.

​
Overview

When the same Google email is authenticated across multiple providers (gemini, agy, codex), simultaneous usage can trigger Google’s abuse detection. CCS automatically isolates accounts to prevent this.
This feature addresses Issue #509. If you use the same Google email across gemini and agy, enable cross-provider isolation.

​
Cross-Provider Isolation

​
How It Works

1

Detect Duplicates

On session launch, CCS scans all providers for emails appearing in 2+ Google OAuth providers
2

Auto-Pause

Conflicting accounts in other providers are temporarily paused
3

Session Runs

Only one provider uses the shared email at a time
4

Auto-Restore

On session exit, paused accounts are restored automatically
Example: If john@gmail.com is authenticated in both gemini and agy, starting a gemini session auto-pauses the agy account for john@gmail.com.

​
Crash Recovery

If CCS crashes without restoring paused accounts:
  • Next launch detects stale sessions (dead PIDs)
  • Automatically restores accounts from dead processes
  • Persistence file: ~/.ccs/cliproxy/auto-paused.json

​
Ban Detection

CCS monitors for ban-related error patterns during sessions: Detected Patterns:
  • disabled in this account
  • violation of terms of service
  • account has been disabled/suspended/banned
On Detection:
  1. Affected account is auto-paused immediately
  2. No further retries on banned account
  3. Warning displayed with box border

​
Runtime Quota Monitoring

Available since v7.42.0. Monitors quota during active sessions, not just at startup.

​
Quota Warning

When quota falls below 20%, CCS displays a warning: 
╔═══════════════════════════════════════╗
║ [!] Quota below 20% for codex        ║
║     Daily: 48/50 messages remaining   ║
╚═══════════════════════════════════════╝

​
Quota Exhaustion

When quota is fully exhausted:
  1. Applies cooldown period to exhausted account
  2. Finds healthy alternative account (if available)
  3. Switches default account automatically
  4. Logs the switch for transparency

​
Antigravity Responsibility Checklist

Available since v7.49.0
When adding a new Antigravity account via the dashboard, a responsibility checklist is displayed. Users must acknowledge guidelines before the account is activated:
  • Account usage policies
  • Rate limit awareness
  • Fair use expectations
This checklist appears in the “Add Account” dialog for the Antigravity provider and helps prevent unintentional policy violations.

​
Configuration

Account safety runs automatically with no configuration needed. Behavior is controlled internally based on provider auth files.

​
Manual Account Management

# Pause an account manually
ccs cliproxy pause <provider> <account>

# Resume a paused account
ccs cliproxy resume <provider> <account>

# Check status of all accounts
ccs cliproxy status

​
Storage

PathPurpose
~/.ccs/cliproxy/auto-paused.jsonAuto-pause session tracking
~/.ccs/cliproxy/accounts.jsonAccount registry with pause state
~/.ccs/cliproxy/auth/OAuth token files per provider

​
Troubleshooting

​
Account Stuck in Paused State

Symptom: Account not rotating after crash Solution: 
# Check paused accounts
ccs cliproxy status <provider>

# Manually resume
ccs cliproxy resume <provider> <account>

​
False Ban Detection

Symptom: Account paused but not actually banned Solution: Resume manually and monitor: 
ccs cliproxy resume <provider> <account>

​
Next Steps

Multi-Account Setup

Configure multiple accounts per provider

Dashboard

Monitor account status via web UI