From 8ea1e333bc2b365b7f058201f714e41e822b815f Mon Sep 17 00:00:00 2001
From: kaitranntt <kaitran.ntt@gmail.com>
Date: Mon, 5 Jan 2026 13:31:34 -0500
Subject: [PATCH] docs(agy): add quota management and failover documentation

- Add ccs cliproxy doctor command to help text
- Document Antigravity auto-failover in README
---
 README.md                    | 8 ++++++++
 src/commands/help-command.ts | 1 +
 2 files changed, 9 insertions(+)

diff --git a/README.md b/README.md
index a380165f..7a4cd177 100644
--- a/README.md
+++ b/README.md
@@ -187,6 +187,14 @@ ccs sync
 
 Re-creates symlinks for shared commands, skills, and settings.
 
+### Antigravity Quota Management
+
+```bash
+ccs cliproxy doctor     # Check quota status for all agy accounts
+```
+
+**Auto-Failover**: When an Antigravity account runs out of quota, CCS automatically switches to another account with remaining capacity. Shared GCP project accounts are excluded (pooled quota).
+
 <br>
 
 ## Configuration
diff --git a/src/commands/help-command.ts b/src/commands/help-command.ts
index ddfa96ef..840ad3d5 100644
--- a/src/commands/help-command.ts
+++ b/src/commands/help-command.ts
@@ -256,6 +256,7 @@ Run ${color('ccs config', 'command')} for web dashboard`.trim();
   printSubSection('CLI Proxy Plus Management', [
     ['ccs cliproxy', 'Show CLIProxy Plus status and version'],
     ['ccs cliproxy --help', 'Full CLIProxy Plus management help'],
+    ['ccs cliproxy doctor', 'Quota diagnostics (Antigravity)'],
     ['ccs cliproxy --install <ver>', 'Install specific version (e.g., 6.6.6)'],
     ['ccs cliproxy --latest', 'Update to latest version'],
   ]);