@polderlabs/bizar 6.2.1 → 6.2.2

package/cli/provision.mjs

@@ -860,94 +860,69 @@ export async function patchClineJson({ dryRun, force }) {
     (p) => Array.isArray(p) && typeof p[0] === 'string' && p[0].includes('plugins/bizar'),
   );
 
-  // v6.2.0 — Multi-patch installer. On every install/update, ensure the
-  // full Bizar config surface is present in cline.json:
+  // v6.2.2 — Multi-patch installer. On every install/update, ensure the
+  // Bizar config surface is present in cline.json:
   //
-  //   1. provider.9router (preferred gateway since v6.0.1) — add if
-  //      missing so the install is "complete" out of the box.
-  //   2. provider.minimax (legacy fallback) — kept for back-compat.
-  //   3. default_agent — set to "odin" if missing.
-  //   4. $schema — add if missing (helps editors validate).
-  //   5. instructions — point at .cline/instructions/bizar-tools.md if
-  //      missing, so Cline loads the tool reference on every session.
-  //   6. plugin entry — add if missing (the critical one; without this
+  //   1. plugin entry — add if missing (the critical one; without this
   //      the Bizar plugin never loads).
-  //   7. permissions — set to "allow" if missing.
-  //   8. snapshot — set to false if missing.
+  //   2. default_agent — set to "odin" if missing.
+  //   3. $schema — add if missing (helps editors validate).
+  //   4. instructions — point at .cline/instructions/bizar-tools.md if
+  //      missing, so Cline loads the tool reference on every session.
+  //   5. permissions — set to "allow" if missing.
+  //   6. snapshot — set to false if missing.
+  //
+  // v6.2.2 REMOVED:
+  //   - provider.9router (was added automatically in v6.0.1–v6.2.1)
+  //   - provider.minimax (legacy fallback)
+  //
+  // Per user request: "the installer should do nothing with providers,
+  // the user has to configure it themselves." The user picks their own
+  // provider, plugs in their API key, and configures which model catalog
+  // to use. The installer just sets up the Bizar scaffolding (plugin
+  // entry, default agent, schema, instructions, etc.) and stays out of
+  // provider configuration entirely.
   //
   // All patches are additive and idempotent. We never overwrite a value
   // the user has set; the `force` flag bypasses that protection for the
   // plugin entry only.
-  let addedProvider = false;
   let addedDefaultAgent = false;
   let addedSchema = false;
   let addedInstructions = false;
   let addedPermissions = false;
   let addedSnapshot = false;
-  let added9router = false;
-
-  if (!cfg.provider) cfg.provider = {};
-
-  // 1. provider.9router — preferred gateway.
-  if (!cfg.provider['9router'] && existsSync(join(REPO_ROOT, 'config', 'cline.json'))) {
-    try {
-      const tpl = JSON.parse(readFileSync(join(REPO_ROOT, 'config', 'cline.json'), 'utf8'));
-      if (tpl.provider && tpl.provider['9router']) {
-        cfg.provider['9router'] = tpl.provider['9router'];
-        added9router = true;
-      }
-    } catch { /* ignore template parse errors */ }
-  }
 
-  // 2. provider.minimax — legacy fallback.
-  const DEFAULT_MINIMAX_BLOCK = {
-    options: {
-      baseURL: 'https://api.minimax.io/v1',
-      apiKey: '{env:MiniMax_API_KEY}',
-    },
-    models: {
-      'MiniMax-M2.7-Flash': { name: 'MiniMax M2.7 Flash', interleaved: { field: 'reasoning_details' }, reasoning: true },
-      'MiniMax-M2.7': { name: 'MiniMax M2.7', interleaved: { field: 'reasoning_details' }, reasoning: true },
-      'MiniMax-M3': { name: 'MiniMax M3', interleaved: { field: 'reasoning_details' }, reasoning: true },
-      'MiniMax-M3-Reasoning': { name: 'MiniMax M3 Reasoning', interleaved: { field: 'reasoning_details' }, reasoning: true },
-    },
-  };
-  if (!cfg.provider.minimax) {
-    cfg.provider.minimax = DEFAULT_MINIMAX_BLOCK;
-    addedProvider = true;
-  }
-
-  // 3. default_agent
+  // 1. default_agent
   if (!cfg.default_agent) {
     cfg.default_agent = 'odin';
     addedDefaultAgent = true;
   }
 
-  // 4. $schema
+  // 2. $schema
   if (!cfg.$schema) {
     cfg.$schema = 'https://docs.cline.bot/config.json';
     addedSchema = true;
   }
 
-  // 5. instructions — point at the bundled Bizar tools reference.
+  // 3. instructions — point at the bundled Bizar tools reference.
   if (!cfg.instructions || (Array.isArray(cfg.instructions) && cfg.instructions.length === 0)) {
     cfg.instructions = ['.cline/instructions/bizar-tools.md'];
     addedInstructions = true;
   }
 
-  // 6. permission
+  // 4. permission
   if (!cfg.permission) {
     cfg.permission = 'allow';
     addedPermissions = true;
   }
 
-  // 7. snapshot
+  // 5. snapshot
   if (typeof cfg.snapshot !== 'boolean') {
     cfg.snapshot = false;
     addedSnapshot = true;
   }
 
-  const anyAdded = addedProvider || added9router || addedDefaultAgent || addedSchema
+  const anyAdded = addedDefaultAgent || addedSchema
     || addedInstructions || addedPermissions || addedSnapshot;
 
   if (hasEntry && !force && !anyAdded) {
@@ -957,8 +932,6 @@ export async function patchClineJson({ dryRun, force }) {
   if (dryRun) {
     const added = [];
     if (!hasEntry) added.push('plugin entry');
-    if (added9router) added.push('provider.9router');
-    if (addedProvider) added.push('provider.minimax');
     if (addedDefaultAgent) added.push('default_agent');
     if (addedSchema) added.push('$schema');
     if (addedInstructions) added.push('instructions');
@@ -988,8 +961,6 @@ export async function patchClineJson({ dryRun, force }) {
   writeFileSync(cfgPath, JSON.stringify(cfg, null, 2) + '\n');
   const added = [];
   if (!hasEntry) added.push('plugin entry');
-  if (added9router) added.push('provider.9router');
-  if (addedProvider) added.push('provider.minimax');
   if (addedDefaultAgent) added.push('default_agent');
   if (addedSchema) added.push('$schema');
   if (addedInstructions) added.push('instructions');
@@ -1973,29 +1944,33 @@ export async function runProvision(opts = {}) {
     console.log(chalk.green(`\n  ✓ ${mode === 'update' ? 'Update' : 'Install'} complete\n`));
   }
 
-  // ── 13. API key bootstrap warning ────────────────────────────────────
-  // v5.x — After a successful install, check whether any API keys are
-  // configured. If not, surface a prominent warning (but don't block —
-  // many users configure keys later).
+  // ── 13. Provider bootstrap warning ───────────────────────────────
+  // v6.2.2 — The installer no longer configures a provider. The user
+  // must add their own. After a successful install, surface a clear
+  // hint pointing them at the right places.
   if (mode === 'install' && !dryRun && !anyFail) {
-    const envJsonPath = join(BIZAR_HOME, 'env.json');
-    const marker = readInstallMarker();
-    const hasApiKeys = Boolean(
-      process.env.OPENAI_API_KEY ||
-      process.env.ANTHROPIC_API_KEY ||
-      process.env.MINIMAX_API_KEY ||
-      (existsSync(envJsonPath) && (() => {
-        try {
-          const env = JSON.parse(readFileSync(envJsonPath, 'utf8'));
-          return Boolean(env?.OPENAI_API_KEY || env?.ANTHROPIC_API_KEY || env?.MINIMAX_API_KEY);
-        } catch { return false; }
-      })())
-    );
-    if (!hasApiKeys) {
-      console.log(chalk.yellow('  ⚠  No API keys configured.'));
-      console.log(chalk.yellow('     Run `bizar connect` to add providers.'));
-      const dashPort = process.env.BIZAR_DASHBOARD_PORT || '4097';
-      console.log(chalk.yellow(`     Or visit http://localhost:${dashPort}/connect after starting the dashboard.`));
+    const cfgPath = join(CLINE_DIR, 'cline.json');
+    const cfg = readJsonSafe(cfgPath, null);
+    const hasProvider = cfg && cfg.provider && Object.keys(cfg.provider).length > 0;
+    if (!hasProvider) {
+      console.log(chalk.yellow('  ⚠  No provider configured in cline.json.'));
+      console.log(chalk.yellow('     `bizar install` no longer touches provider config (v6.2.2+).'));
+      console.log(chalk.yellow('     You must add one yourself — see the "Provider setup" section below.'));
+      console.log('');
+      console.log(chalk.cyan('  ┌─ Provider setup ─────────────────────────────────────────────┐'));
+      console.log(chalk.cyan('  │ 1. Edit ~/.cline/cline.json and add a `provider` block:        │'));
+      console.log(chalk.cyan('  │    { "provider": { "9router": {                              │'));
+      console.log(chalk.cyan('  │        "baseUrl": "http://localhost:20128/v1",                │'));
+      console.log(chalk.cyan('  │        "apiKey": "<your-key>",                                │'));
+      console.log(chalk.cyan('  │        "models": { "minimax/MiniMax-M3": {},                  │'));
+      console.log(chalk.cyan('  │                    "minimax/MiniMax-M2.7": {} } } }            │'));
+      console.log(chalk.cyan('  │                                                              │'));
+      console.log(chalk.cyan('  │ 2. Or run `bizar connect` for an interactive TUI setup.       │'));
+      console.log(chalk.cyan('  └──────────────────────────────────────────────────────────────┘'));
+      console.log('');
+      console.log(chalk.dim('  Models available at http://localhost:20128/v1/models:'));
+      console.log(chalk.dim('    minimax/MiniMax-M3, minimax/MiniMax-M2.7, nvidia/minimaxai/minimax-m3,'));
+      console.log(chalk.dim('    nvidia/z-ai/glm-5.2, nvidia/deepseek-ai/deepseek-v4-pro, etc.'));
       console.log('');
     }
   }

package/config/agents/baldr.md

@@ -1,7 +1,7 @@
 ---
 description: Baldr — UI/UX design system specialist. Creates DESIGN.md files using Google's design.md standard. Aesthetic direction, typography, design tokens, anti-slop audits. Does not implement code.
 mode: subagent
-model: minimax/MiniMax-M2.7
+model: minimaxcustom/MiniMax-M2.7
 color: "#ec4899"
 permission:
   read: allow

package/config/agents/forseti.md

@@ -1,7 +1,7 @@
 ---
 description: Forseti — Audits, criticizes, and corrects implementation plans before execution. No write permissions. Review only.
 mode: subagent
-model: minimax/MiniMax-M3
+model: minimaxcustom/MiniMax-M3
 color: "#ef4444"
 permission:
   read: allow

package/config/agents/frigg.md

@@ -1,7 +1,7 @@
 ---
 description: Frigg — Read-only codebase Q&A. Answers questions about the project with file references, never modifies anything. Routes to no one.
 mode: subagent
-model: minimax/MiniMax-M2.7
+model: minimaxcustom/MiniMax-M2.7
 color: "#f472b6"
 permission:
   read: allow

package/config/agents/heimdall.md

@@ -1,7 +1,7 @@
 ---
 description: Heimdall — Simple, routine, and deterministic tasks using DeepSeek. Quick edits, mechanical work, file operations. The ever-watchful guardian.
 mode: subagent
-model: minimax/MiniMax-M2.7
+model: minimaxcustom/MiniMax-M2.7
 color: "#10b981"
 permission:
   read: allow

package/config/agents/hermod.md

@@ -1,7 +1,7 @@
 ---
 description: Hermod — Git and GitHub operations specialist using MiniMax M2.7. The only agent allowed to perform write-level git (commit, push, merge, rebase, branch) and `gh` CLI operations.
 mode: subagent
-model: minimax/MiniMax-M2.7
+model: minimaxcustom/MiniMax-M2.7
 color: "#f59e0b"
 permission:
   read: allow

package/config/agents/mimir.md

@@ -1,7 +1,7 @@
 ---
 description: Mimir — Deep codebase research and exploration. Uses Semble as primary search tool. Architecture analysis, pattern discovery, documentation research, and project initialization.
 mode: subagent
-model: minimax/MiniMax-M2.7
+model: minimaxcustom/MiniMax-M2.7
 color: "#06b6d4"
 permission:
   read: allow

package/config/agents/odin.md

@@ -1,7 +1,7 @@
 ---
 description: Odin — Pure router that delegates all work to subagents. Routes across Frigg (DeepSeek/Q&A), Vör (DeepSeek/clarify), Mimir (DeepSeek/research), Heimdall (DeepSeek/simple), Hermod (M2.7/git), Thor (M2.7/mid), Baldr (M2.7/design), Tyr (M3/top), Vidarr (GPT-5.5/ultra), Forseti (verifier/M3).
 mode: primary
-model: minimax/MiniMax-M3
+model: minimaxcustom/MiniMax-M3
 color: "#6366f1"
 permission:
   task: allow

package/config/agents/quick.md

@@ -1,7 +1,7 @@
 ---
 description: Quick (quick) — fast single-shot tasks. No delegation, no parallel streams. Use for small edits, mechanical changes, one-shot questions. Routes to no one.
 mode: primary
-model: minimax/MiniMax-M2.7-Flash
+model: minimaxcustom/MiniMax-M2.7-highspeed
 color: "#22d3ee"
 permission:
   read: allow

package/config/agents/semble-search.md

@@ -1,7 +1,7 @@
 ---
 description: Code search agent for exploring any codebase. Use for finding code by intent, locating implementations, understanding how something works, or discovering related code. Prefer over Bash/Read for any semantic or exploratory question.
 mode: subagent
-model: minimax/MiniMax-M2.7
+model: minimaxcustom/MiniMax-M2.7
 color: "#64748b"
 permission:
   read: allow

package/config/agents/thor.md

@@ -1,7 +1,7 @@
 ---
 description: Thor — Handles medium-complexity implementation tasks using MiniMax M2.7. New features, non-trivial debugging, refactoring, code review, and writing tests.
 mode: subagent
-model: minimax/MiniMax-M2.7
+model: minimaxcustom/MiniMax-M2.7
 color: "#a855f7"
 permission:
   read: allow

package/config/agents/tyr.md

@@ -1,7 +1,7 @@
 ---
 description: Tyr — Handles the most complex implementation, debugging, and architectural work using MiniMax M3. Reserved for the hardest problems. Always plan-then-Forseti-gate.
 mode: subagent
-model: minimax/MiniMax-M3
+model: minimaxcustom/MiniMax-M3
 color: "#dc2626"
 permission:
   read: allow

package/config/agents/vidarr.md

@@ -1,7 +1,7 @@
 ---
 description: Vidarr — The ultimate fallback via MiniMax M3. For the hardest problems when Tyr stalls, debugging is stuck, or novel insight is needed. Use sparingly — highest cost.
 mode: subagent
-model: minimax/MiniMax-M3
+model: minimaxcustom/MiniMax-M3
 color: "#0ea5e9"
 permission:
   read: allow

package/config/agents/vor.md

@@ -1,7 +1,7 @@
 ---
 description: Vör — Asks clarifying questions for ambiguous or incomplete requests. Reads project context first, then asks one targeted, project-specific question.
 mode: subagent
-model: minimax/MiniMax-M2.7
+model: minimaxcustom/MiniMax-M2.7
 color: "#a78bfa"
 permission:
   read: allow

package/config/cline.json.template

@@ -1,8 +1,8 @@
 {
   "$schema": "https://docs.cline.bot/config.json",
   "instructions": [".cline/instructions/bizar-tools.md"],
-  "model": "9router/minimax/MiniMax-M3",
-  "small_model": "9router/minimax/MiniMax-M2.7",
+  "model": "minimaxcustom/MiniMax-M3",
+  "small_model": "minimaxcustom/MiniMax-M2.7",
   "default_agent": "odin",
   "permission": "allow",
   "snapshot": false,
@@ -35,7 +35,7 @@
         "threshold": 0.5,
         "preserve_recent": 10,
         "strategy": "summarize",
-        "model": "9router/minimax/MiniMax-M3"
+        "model": "minimaxcustom/MiniMax-M3"
       }
     }]
   ],
@@ -52,7 +52,7 @@
     "odin": {
       "description": "Odin — Pure router that delegates all work to subagents.",
       "mode": "primary",
-      "model": "9router/minimax/MiniMax-M3",
+      "model": "minimaxcustom/MiniMax-M3",
       "color": "#6366f1",
       "permission": {
         "task": "allow",
@@ -66,7 +66,7 @@
     "vor": {
       "description": "Vör — The Questioning One.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#8b5cf6",
       "permission": {
         "read": "allow",
@@ -77,7 +77,7 @@
     "frigg": {
       "description": "Frigg — All-knowing Q&A agent.",
       "mode": "primary",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#06b6d4",
       "permission": {
         "read": "allow",
@@ -93,7 +93,7 @@
     "quick": {
       "description": "Quick — Fast single-shot tasks.",
       "mode": "primary",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#22d3ee",
       "permission": {
         "read": "allow",
@@ -112,7 +112,7 @@
     "mimir": {
       "description": "Mimir — Research and codebase exploration agent.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#0ea5e9",
       "permission": {
         "read": "allow",
@@ -130,7 +130,7 @@
     "heimdall": {
       "description": "Heimdall — Simple, routine, deterministic tasks.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#10b981",
       "permission": {
         "read": "allow",
@@ -147,7 +147,7 @@
     "hermod": {
       "description": "Hermod — Git and GitHub operations specialist.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#06b6d4",
       "permission": {
         "read": "allow",
@@ -163,7 +163,7 @@
     "thor": {
       "description": "Thor — Medium-complexity tasks, strong and reliable.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#a855f7",
       "permission": {
         "read": "allow",
@@ -180,7 +180,7 @@
     "baldr": {
       "description": "Baldr — UI/UX design system specialist.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#ec4899",
       "permission": {
         "read": "allow",
@@ -197,7 +197,7 @@
     "tyr": {
       "description": "Tyr — Complex implementation, debugging, architecture.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M3",
+      "model": "minimaxcustom/MiniMax-M3",
       "color": "#f59e0b",
       "permission": {
         "read": "allow",
@@ -214,7 +214,7 @@
     "vidarr": {
       "description": "Vidarr — Ultimate fallback via MiniMax M3.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M3",
+      "model": "minimaxcustom/MiniMax-M3",
       "color": "#dc2626",
       "permission": {
         "read": "allow",
@@ -231,7 +231,7 @@
     "forseti": {
       "description": "Forseti — Audits and corrects plans before execution.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M3",
+      "model": "minimaxcustom/MiniMax-M3",
       "color": "#ef4444",
       "permission": {
         "read": "allow",
@@ -249,7 +249,7 @@
     "browser-harness": {
       "description": "browser-harness — Primary agent for browser-driven E2E verification. No-edit permissions. Drives Chrome via CDP for end-to-end testing of web apps.",
       "mode": "primary",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#84cc16",
       "permission": {
         "read": "allow",
@@ -332,84 +332,11 @@
       "description": "Validate the Bizar install: cline.json, plugin entry, agents, skills, hooks, rules, commands, and provider config.",
       "agent": "heimdall",
       "template": "commands-bizar/validate.md\n\n$ARGUMENTS"
-    }
-  },
-  "provider": {
-    "9router": {
-      "baseUrl": "http://localhost:20128/v1",
-      "apiKey": "${env:NINEROUTER_KEY}",
-      "models": {
-        "minimax/MiniMax-M3": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "minimax/MiniMax-M2.7": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "minimax/MiniMax-M2.5": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "minimax/MiniMax-M2.1": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "kr/auto": {
-          "reasoning": false
-        },
-        "kr/auto-thinking": {
-          "reasoning": true
-        },
-        "kr/claude-sonnet-4.5": {
-          "reasoning": false
-        },
-        "kr/claude-haiku-4.5": {
-          "reasoning": false
-        },
-        "kr/deepseek-3.2": {
-          "reasoning": false
-        },
-        "openrouter/cohere/north-mini-code:free": {
-          "reasoning": false
-        },
-        "openrouter/poolside/laguna-m.1:free": {
-          "reasoning": false
-        },
-        "openrouter/nvidia/nemotron-3-super-120b-a12b:free": {
-          "reasoning": true
-        }
-      }
     },
-    "minimax": {
-      "models": {
-        "MiniMax-M3": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "MiniMax-M2.7": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        }
-      }
+    "setup-provider": {
+      "description": "Configure a provider in cline.json. Since v6.2.2 the installer no longer touches provider config — use this to add your own.",
+      "agent": "heimdall",
+      "template": "commands-bizar/setup-provider.md\n\n$ARGUMENTS"
     }
   }
 }

package/config/commands/setup-provider.md

@@ -0,0 +1,95 @@
+---
+description: Configure a provider in cline.json (apiKey, baseUrl, model catalog). The installer no longer touches provider config — use this command to set one up.
+agent: heimdall
+---
+# /setup-provider — Configure a provider in cline.json
+
+The Bizar installer no longer configures a provider for you (since
+v6.2.2 — the user owns provider config). Use this command to add
+or update a provider in `~/.cline/cline.json`.
+
+## What It Does
+
+Interactively (or non-interactively with flags), the setup-provider
+command writes a `provider` block to `~/.cline/cline.json` with:
+
+- `baseUrl` — the API endpoint (e.g. `http://localhost:20128/v1` for
+  the local 9Router gateway)
+- `apiKey` — the provider's API key (read from `env:` reference or
+  direct value)
+- `models` — the model catalog (the IDs returned by
+  `GET /v1/models`)
+
+## Default: 9Router Gateway
+
+If the user invokes `/setup-provider` with no arguments, default to
+the local 9Router gateway at `http://localhost:20128/v1`. The
+catalog comes from `GET http://localhost:20128/v1/models`. As of
+v6.2.2, that catalog includes:
+
+- `minimax/MiniMax-M3` (reasoning)
+- `minimax/MiniMax-M2.7` (reasoning)
+- `nvidia/minimaxai/minimax-m3` (reasoning)
+- `nvidia/minimaxai/minimax-m2.7` (reasoning)
+- `nvidia/z-ai/glm-5.2`
+- `nvidia/deepseek-ai/deepseek-v4-pro`
+- `nvidia/deepseek-ai/deepseek-v4-flash`
+- `nvidia/moonshotai/kimi-k2.6`
+- `nvidia/nemotron-3-ultra-550b-a55b`
+- `openrouter/cohere/north-mini-code:free`
+- `openrouter/poolside/laguna-m.1:free`
+- `openrouter/nvidia/nemotron-3-super-120b-a12b:free`
+- (and several more `minimax/MiniMax-M2.x` variants)
+
+## Flags
+
+- `--gateway <url>` — override the 9Router URL (default
+  `http://localhost:20128/v1`)
+- `--key <key>` — provider API key (writes `${env:KEY_NAME}` if it
+  looks like an env var name, otherwise writes the literal)
+- `--provider <name>` — provider name in cline.json (default `9router`)
+- `--model <id>` — add a single model instead of fetching the catalog
+- `--list` — print the model catalog from `/v1/models` and exit
+- `--remove <name>` — remove a provider by name
+
+## Examples
+
+```
+# Use the default 9Router gateway with the live model catalog
+/setup-provider
+
+# Custom provider
+/setup-provider --provider my-anthropic --gateway https://api.anthropic.com/v1 --key sk-ant-...
+
+# Just list the available models
+/setup-provider --list
+```
+
+## Implementation
+
+1. If `--list`, GET `${gateway}/v1/models` and pretty-print the IDs.
+2. If `--remove`, edit `~/.cline/cline.json` and remove the
+   `provider.<name>` block.
+3. Otherwise, read `~/.cline/cline.json`. If the file doesn't
+   exist, error — the user should run `bizar install` first.
+4. Build the new `provider.<name>` block from the flags + fetched
+   catalog.
+5. Write the file back atomically (write to `cline.json.tmp`,
+   then `rename`).
+6. Run `bizar validate` to confirm everything is wired up.
+
+## Security
+
+Never echo or log the full API key. If the user supplies a key on
+the command line, write it as a literal value (or `${env:KEY}`
+reference if it matches a `KEY_NAME` pattern). Never commit
+`~/.cline/cline.json` to source control — it may contain real
+secrets.
+
+## Related
+
+- `bizar connect` — interactive TUI for provider setup (alternative)
+- `bizar install` — installs the Bizar scaffolding (NOT provider config
+  since v6.2.2)
+- `bizar validate` — confirms provider config is wired correctly
+- Cline provider config: https://docs.cline.bot/customization/providers