feat(cliproxy): add crud commands for variant profiles

- Add `ccs cliproxy create/list/remove` commands for variant management
- Interactive wizard with provider/model selection from catalog
- Settings file auto-generated with all 6 ANTHROPIC_* env fields
- Fix `ccs api create` to include all 4 model fields (was missing 3)
- Fix `--config` flag to save to correct variant settings file
- Remove paid tier badge from AGY models (all free via Antigravity)
- Add settings file format example to README for CLIProxy variants
- Add 22 unit tests for cliproxy command validation and config handling

Author: kaitranntt

README.md

@@ -411,6 +411,24 @@ CCS resolves profiles in priority order:
 
 Usage: `ccs flash "quick task"` or `ccs pro "complex analysis"`
 
+Settings file format (`~/.ccs/gemini-flash.settings.json`):
+
+```json
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8317/api/provider/gemini",
+    "ANTHROPIC_AUTH_TOKEN": "ccs-internal-managed",
+    "ANTHROPIC_MODEL": "gemini-2.5-flash",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-2.5-flash",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-2.5-flash",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-2.5-flash"
+  }
+}
+```
+
+> [!TIP]
+> Copy from `~/.ccs/gemini.settings.json` (auto-generated on first `ccs gemini` run) and modify `ANTHROPIC_MODEL` to your desired model.
+
 **Settings-based**: GLM, GLMT, Kimi, default
 - Uses `--settings` flag pointing to config files
 - GLMT: Embedded proxy for thinking mode support

src/cliproxy/cliproxy-executor.ts

@@ -125,8 +125,9 @@ export async function execClaudeWithCLIProxy(
   const forceConfig = args.includes('--config');
 
   // Handle --config: configure model selection and exit
+  // Pass customSettingsPath for CLIProxy variants to save to correct file
   if (forceConfig && supportsModelConfig(provider)) {
-    await configureProviderModel(provider, true);
+    await configureProviderModel(provider, true, cfg.customSettingsPath);
     process.exit(0);
   }
 
@@ -166,12 +167,13 @@ export async function execClaudeWithCLIProxy(
 
   // 4. First-run model configuration (interactive)
   // For supported providers, prompt user to select model on first run
+  // Pass customSettingsPath for CLIProxy variants
   if (supportsModelConfig(provider)) {
-    await configureProviderModel(provider, false); // false = only if not configured
+    await configureProviderModel(provider, false, cfg.customSettingsPath); // false = only if not configured
   }
 
   // 5. Check for known broken models and warn user
-  const currentModel = getCurrentModel(provider);
+  const currentModel = getCurrentModel(provider, cfg.customSettingsPath);
   if (currentModel && isModelBroken(provider, currentModel)) {
     const modelEntry = findModel(provider, currentModel);
     const issueUrl = getModelIssueUrl(provider, currentModel);

src/cliproxy/model-catalog.ts

@@ -64,8 +64,7 @@ export const MODEL_CATALOG: Partial<Record<CLIProxyProvider, ProviderCatalog>> =
       {
         id: 'gemini-3-pro-preview',
         name: 'Gemini 3 Pro',
-        tier: 'paid',
-        description: 'Google latest, requires paid Google account',
+        description: 'Google latest model via Antigravity',
       },
     ],
   },

src/cliproxy/model-config.ts

@@ -40,9 +40,16 @@ export function hasUserSettings(provider: CLIProxyProvider): boolean {
 
 /**
  * Get current model from user settings
+ * @param provider CLIProxy provider
+ * @param customSettingsPath Optional custom settings path for CLIProxy variants
  */
-export function getCurrentModel(provider: CLIProxyProvider): string | undefined {
-  const settingsPath = getProviderSettingsPath(provider);
+export function getCurrentModel(
+  provider: CLIProxyProvider,
+  customSettingsPath?: string
+): string | undefined {
+  const settingsPath = customSettingsPath
+    ? customSettingsPath.replace(/^~/, process.env.HOME || process.env.USERPROFILE || '')
+    : getProviderSettingsPath(provider);
   if (!fs.existsSync(settingsPath)) return undefined;
 
   try {
@@ -80,11 +87,13 @@ function formatModelDetailed(model: ModelEntry, isCurrent: boolean): string {
  *
  * @param provider CLIProxy provider (agy, gemini)
  * @param force Force reconfiguration even if settings exist
+ * @param customSettingsPath Optional custom settings path for CLIProxy variants
  * @returns true if configuration was performed, false if skipped
  */
 export async function configureProviderModel(
   provider: CLIProxyProvider,
-  force: boolean = false
+  force: boolean = false,
+  customSettingsPath?: string
 ): Promise<boolean> {
   // Check if provider supports model configuration
   if (!supportsModelConfig(provider)) {
@@ -94,7 +103,10 @@ export async function configureProviderModel(
   const catalog = getProviderCatalog(provider);
   if (!catalog) return false;
 
-  const settingsPath = getProviderSettingsPath(provider);
+  // Use custom settings path for CLIProxy variants, otherwise use default provider path
+  const settingsPath = customSettingsPath
+    ? customSettingsPath.replace(/^~/, process.env.HOME || process.env.USERPROFILE || '')
+    : getProviderSettingsPath(provider);
 
   // Skip if already configured (unless --config flag)
   if (!force && fs.existsSync(settingsPath)) {
@@ -111,7 +123,7 @@ export async function configureProviderModel(
   }));
 
   // Find default index - use current model if configured, otherwise catalog default
-  const currentModel = getCurrentModel(provider);
+  const currentModel = getCurrentModel(provider, customSettingsPath);
   const targetModel = currentModel || catalog.defaultModel;
   const defaultIdx = catalog.models.findIndex((m) => m.id === targetModel);
   const safeDefaultIdx = defaultIdx >= 0 ? defaultIdx : 0;

src/commands/api-command.ts

@@ -109,6 +109,7 @@ function apiExists(name: string): boolean {
 
 /**
  * Create settings.json file for API profile
+ * Includes all 4 model fields for proper Claude CLI integration
  */
 function createSettingsFile(name: string, baseUrl: string, apiKey: string, model: string): string {
   const ccsDir = getCcsDir();
@@ -119,6 +120,9 @@ function createSettingsFile(name: string, baseUrl: string, apiKey: string, model
       ANTHROPIC_BASE_URL: baseUrl,
       ANTHROPIC_AUTH_TOKEN: apiKey,
       ANTHROPIC_MODEL: model,
+      ANTHROPIC_DEFAULT_OPUS_MODEL: model,
+      ANTHROPIC_DEFAULT_SONNET_MODEL: model,
+      ANTHROPIC_DEFAULT_HAIKU_MODEL: model,
     },
   };