feat(providers): add ClinePass and Command Code GOAT

docs/environment-variables.md

@@ -81,6 +81,8 @@ These are consumed via `getEnvApiKey()` (`packages/ai/src/stream.ts`) unless not
 | `AI_GATEWAY_API_KEY`            | Vercel AI Gateway auth                           | Using `vercel-ai-gateway` provider                             |                                                                                                     |
 | `CLOUDFLARE_AI_GATEWAY_API_KEY` | Cloudflare AI Gateway auth                       | Using `cloudflare-ai-gateway` provider                         | Base URL must be configured as `https://gateway.ai.cloudflare.com/v1/<account>/<gateway>/anthropic` |
 | `ALIBABA_TOKEN_PLAN_API_KEY`    | Alibaba Token Plan auth                          | Using `alibaba-token-plan` provider                            |                                                                                                     |
+| `CLINE_API_KEY`                 | Cline API / ClinePass auth                       | Using the `cline-pass` provider preset                         | Create under Settings > API Keys in the Cline dashboard                                              |
+| `CMD_API_KEY`                   | Command Code Provider API auth                   | Using the `commandcode-goat` provider preset                   | The GOAT coding plan may use this API according to its plan entitlement                              |
 | `DEEPSEEK_API_KEY`              | DeepSeek auth                                    | Using DeepSeek models                                          |                                                                                                     |
 | `KILO_API_KEY`                  | Kilo auth                                        | Using Kilo models                                              |                                                                                                     |
 | `OLLAMA_CLOUD_API_KEY`          | Ollama Cloud auth                                | Using `ollama-cloud` provider                                  |                                                                                                     |

docs/models.md

@@ -162,15 +162,17 @@ providers:
       - id: anthropic.claude-3-5-sonnet-20241022-v2:0
 ```
 
-### MiniMax and GLM custom provider examples
+### Coding-plan provider presets
 
-For common MiniMax and GLM/zAI setup, prefer the provider presets so the OpenAI-compatible API, base URL, env var, model id, and compatibility flags are written together:
+For supported coding-plan providers, prefer presets so the API type, base URL, environment variable, model catalog, discovery behavior, and compatibility flags are written together:
 
 ```sh
 gjc setup provider --preset minimax
 gjc setup provider --preset minimax-cn
 gjc setup provider --preset glm
 gjc setup provider --preset alibaba-token-plan
+gjc setup provider --preset cline-pass
+gjc setup provider --preset commandcode-goat
 ```
 
 The same presets are available inside the TUI:
@@ -180,9 +182,11 @@ The same presets are available inside the TUI:
 /provider add --preset glm
 /provider add zai
 /provider add --preset alibaba-token-plan
+/provider add --preset cline-pass
+/provider add --preset commandcode-goat
 ```
 
-Presets only write `models.yml` entries that reference documented environment variable names (`MINIMAX_CODE_API_KEY`, `MINIMAX_CODE_CN_API_KEY`, `ZAI_API_KEY`, or `ALIBABA_TOKEN_PLAN_API_KEY`); they do not store or validate real credentials. The GLM preset aliases (`glm`, `zai`, `z-ai`) write an OpenAI-compatible custom provider named `glm-proxy` and do not replace the first-class `zai` provider. The Alibaba Token Plan preset (aliases: alibaba, token-plan) writes an OpenAI-compatible custom provider named alibaba-token-plan with per-model API routing (qwen3.8-max-preview uses openai-responses; glm-5.2, deepseek-v4-pro, and deepseek-v4-flash-0731 use openai-completions).
+Presets only write `models.yml` entries that reference documented environment variable names (`MINIMAX_CODE_API_KEY`, `MINIMAX_CODE_CN_API_KEY`, `ZAI_API_KEY`, `ALIBABA_TOKEN_PLAN_API_KEY`, `CLINE_API_KEY`, or `CMD_API_KEY`); they do not store or validate real credentials. The GLM preset aliases (`glm`, `zai`, `z-ai`) write an OpenAI-compatible custom provider named `glm-proxy` and do not replace the first-class `zai` provider. The Alibaba Token Plan preset (aliases: `alibaba`, `token-plan`) writes an OpenAI-compatible custom provider named `alibaba-token-plan` with per-model API routing. The ClinePass preset (aliases: `clinepass`, `cline`) does not hardcode models: Cline's inference API has no working `/models` route, so GJC follows Cline's own catalog-generation source and fetches the live `cline-pass` provider catalog from `https://models.dev/api.json`. The Command Code GOAT preset (aliases: `commandcode`, `command-code`, `goat`) fetches its live `/provider/v1/models` catalog, routes every current or future `claude-*` model through Anthropic Messages, and routes other models through Chat Completions. Create the corresponding API key in the provider dashboard before inference; plan entitlement is enforced by the provider.
 
 ## Model profiles (`--mpreset`)
 

packages/coding-agent/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+### Added
+
+- Added first-class `cline-pass` and `commandcode-goat` provider presets with documented API endpoints, environment-variable credentials, non-hardcoded live model discovery from models.dev and the Command Code Provider API, and prefix-based Claude routing.
+
 ## [0.12.15] - 2026-08-06
 
 ## [0.12.14] - 2026-08-06

packages/coding-agent/src/cli/setup-cli.ts

@@ -113,7 +113,7 @@ function rejectProviderFlagsOutsideProvider(component: SetupComponent, flags: Se
 	console.error(chalk.red("Provider setup flags require the explicit `provider` component."));
 	console.error(
 		chalk.dim(
-			`Run: ${APP_NAME} setup provider --preset <minimax|glm> or ${APP_NAME} setup provider --compat <openai|anthropic> --provider <id> --base-url <url> --api-key-env <ENV> --model <id>`,
+			`Run: ${APP_NAME} setup provider --preset <id> (see --help for presets) or ${APP_NAME} setup provider --compat <openai|anthropic> --provider <id> --base-url <url> --api-key-env <ENV> --model <id>`,
 		),
 	);
 	process.exit(1);
@@ -731,6 +731,8 @@ ${chalk.bold("Components:")}
 ${chalk.bold("Provider example:")}
   ${APP_NAME} setup provider --preset minimax
   ${APP_NAME} setup provider --preset glm
+  ${APP_NAME} setup provider --preset cline-pass
+  ${APP_NAME} setup provider --preset commandcode-goat
   MY_PROVIDER_KEY=sk-... ${APP_NAME} setup provider --compat openai --provider my-oai --base-url https://api.example.com/v1 --api-key-env MY_PROVIDER_KEY --model gpt-example
 
 ${chalk.bold("Hermes example:")}
@@ -743,7 +745,7 @@ ${chalk.bold("Options:")}
   -c, --check       Check if dependencies are installed without installing
   -f, --force       Overwrite existing default workflow skill files
   --json            Output status as JSON
-  --preset          Provider preset: minimax, minimax-cn, or glm (aliases include minimax-code and zai)
+  --preset          Provider preset id (run setup provider --help to list available presets)
   --compat          Provider compatibility: openai or anthropic
   --provider        Provider id to add to models.yml
   --base-url        Provider API base URL

packages/coding-agent/src/config/model-registry.ts

@@ -2154,7 +2154,8 @@ export class ModelRegistry {
 				: strategy;
 		const mergeInput = await this.#discoveryManager.discover(effectiveProviderConfig, refreshStrategy, {
 			cacheDbPath: this.#cacheDbPath,
-			requiresAuth: provider => !this.#isCredentiallessProvider(provider.provider),
+			requiresAuth: provider =>
+				provider.discovery.type !== "models-dev" && !this.#isCredentiallessProvider(provider.provider),
 			peekApiKey: async provider =>
 				preflightCompleted
 					? preflightApiKey
@@ -2244,6 +2245,8 @@ export class ModelRegistry {
 			case "lm-studio":
 			case "openai-models-list":
 				return this.#discoverOpenAIModelsList(providerConfig, apiKey);
+			case "models-dev":
+				return this.#discoverModelsDevProvider(providerConfig);
 		}
 	}
 
@@ -2624,22 +2627,22 @@ export class ModelRegistry {
 		const baseUrl = this.#normalizeLlamaCppBaseUrl(providerConfig.baseUrl);
 		const modelsUrl = `${baseUrl}/models`;
 
-		const headers: Record<string, string> = { ...(providerConfig.headers ?? {}) };
+		const requestHeaders: Record<string, string> = { ...(providerConfig.headers ?? {}) };
 		const apiKey =
 			discoveryApiKey ??
 			(this.#isCredentiallessProvider(providerConfig.provider)
 				? kNoAuth
 				: await this.authStorage.getApiKey(providerConfig.provider));
 		if (apiKey && apiKey !== DEFAULT_LOCAL_TOKEN && apiKey !== kNoAuth) {
-			headers.Authorization = `Bearer ${apiKey}`;
+			requestHeaders.Authorization = `Bearer ${apiKey}`;
 		}
 
 		const [response, serverMetadata] = await Promise.all([
 			fetch(modelsUrl, {
-				headers,
+				headers: requestHeaders,
 				signal: AbortSignal.timeout(250),
 			}),
-			this.#discoverLlamaCppServerMetadata(baseUrl, headers),
+			this.#discoverLlamaCppServerMetadata(baseUrl, requestHeaders),
 		]);
 		if (!response.ok) {
 			throw new Error(`HTTP ${response.status} from ${modelsUrl}`);
@@ -2662,7 +2665,7 @@ export class ModelRegistry {
 					cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
 					contextWindow: serverMetadata?.contextWindow ?? 128000,
 					maxTokens: Math.min(serverMetadata?.contextWindow ?? Number.POSITIVE_INFINITY, 8192),
-					headers,
+					headers: providerConfig.headers,
 					compat: {
 						supportsStore: false,
 						supportsDeveloperRole: false,
@@ -2674,6 +2677,65 @@ export class ModelRegistry {
 		return this.#applyProviderModelOverrides(providerConfig.provider, discovered);
 	}
 
+	#resolveDiscoveredModelApi(providerConfig: DiscoveryProviderConfig, modelId: string): Api {
+		let api = providerConfig.api;
+		let matchedPrefixLength = -1;
+		for (const [prefix, routedApi] of Object.entries(providerConfig.discovery.apiByModelPrefix ?? {})) {
+			if (modelId.startsWith(prefix) && prefix.length > matchedPrefixLength) {
+				api = routedApi;
+				matchedPrefixLength = prefix.length;
+			}
+		}
+		return api;
+	}
+
+	async #discoverModelsDevProvider(providerConfig: DiscoveryProviderConfig): Promise<Model<Api>[]> {
+		const baseUrl = providerConfig.baseUrl;
+		if (!baseUrl) throw new Error(`Provider "${providerConfig.provider}" requires baseUrl for models.dev discovery.`);
+		const response = await fetch("https://models.dev/api.json", {
+			headers: { Accept: "application/json" },
+			signal: AbortSignal.timeout(5_000),
+		});
+		if (!response.ok) throw new Error(`HTTP ${response.status} from https://models.dev/api.json`);
+		const payload: unknown = await response.json();
+		if (!isRecord(payload)) return [];
+		const catalogProvider = payload[providerConfig.discovery.modelsDevProvider ?? providerConfig.provider];
+		if (!isRecord(catalogProvider) || !isRecord(catalogProvider.models)) return [];
+
+		const discovered: Model<Api>[] = [];
+		for (const [catalogId, value] of Object.entries(catalogProvider.models)) {
+			if (!isRecord(value) || value.tool_call !== true || value.status === "deprecated") continue;
+			const id = typeof value.id === "string" && value.id.trim() ? value.id : catalogId;
+			const limit = isRecord(value.limit) ? value.limit : {};
+			const cost = isRecord(value.cost) ? value.cost : {};
+			const modalities = isRecord(value.modalities) ? value.modalities : {};
+			const inputModalities = Array.isArray(modalities.input) ? modalities.input : [];
+			const outputModalities = Array.isArray(modalities.output) ? modalities.output : [];
+			discovered.push(
+				enrichModelThinking({
+					id,
+					name: typeof value.name === "string" && value.name.trim() ? value.name : id,
+					api: this.#resolveDiscoveredModelApi(providerConfig, id),
+					provider: providerConfig.provider,
+					baseUrl,
+					reasoning: value.reasoning === true,
+					input: inputModalities.includes("image") ? ["text", "image"] : ["text"],
+					output: outputModalities.includes("image") ? ["text", "image"] : ["text"],
+					cost: {
+						input: toPositiveNumberOrUndefined(cost.input) ?? 0,
+						output: toPositiveNumberOrUndefined(cost.output) ?? 0,
+						cacheRead: toPositiveNumberOrUndefined(cost.cache_read) ?? 0,
+						cacheWrite: toPositiveNumberOrUndefined(cost.cache_write) ?? 0,
+					},
+					contextWindow: toPositiveNumberOrUndefined(limit.context) ?? UNK_CONTEXT_WINDOW,
+					maxTokens: toPositiveNumberOrUndefined(limit.output) ?? UNK_MAX_TOKENS,
+					headers: providerConfig.headers,
+				}),
+			);
+		}
+		return this.#applyProviderModelOverrides(providerConfig.provider, discovered);
+	}
+
 	async #discoverOpenAIModelsList(
 		providerConfig: DiscoveryProviderConfig,
 		discoveryApiKey?: string,
@@ -2683,7 +2745,7 @@ export class ModelRegistry {
 		const requestBaseUrl = baseUrl;
 		modelsUrl.pathname = `${modelsUrl.pathname.replace(/\/+$/g, "")}/models`;
 
-		const headers: Record<string, string> = { ...(providerConfig.headers ?? {}) };
+		const requestHeaders: Record<string, string> = { ...(providerConfig.headers ?? {}) };
 		// Resolve with the same baseUrl context completion requests use so an
 		// endpoint-scoped (or config-pinned) credential wins here exactly as it
 		// does for chat completions.
@@ -2693,12 +2755,12 @@ export class ModelRegistry {
 				? kNoAuth
 				: await this.authStorage.getApiKey(providerConfig.provider, undefined, { baseUrl }));
 		if (apiKey && apiKey !== DEFAULT_LOCAL_TOKEN && apiKey !== kNoAuth) {
-			headers.Authorization = `Bearer ${apiKey}`;
+			requestHeaders.Authorization = `Bearer ${apiKey}`;
 		}
 
 		const response = await fetch(modelsUrl, {
-			headers,
-			signal: AbortSignal.timeout(250),
+			headers: requestHeaders,
+			signal: AbortSignal.timeout(5_000),
 		});
 		if (!response.ok) {
 			if (response.status === 401 || response.status === 403) {
@@ -2710,26 +2772,33 @@ export class ModelRegistry {
 			}
 			throw new Error(`HTTP ${response.status} from ${redactDiscoveryUrl(modelsUrl)}`);
 		}
-		const payload = (await response.json()) as { data?: Array<{ id: string }> };
+		const payload = (await response.json()) as {
+			data?: Array<{ id: string; name?: string; context_length?: number }>;
+		};
 		const models = payload.data ?? [];
 		const discovered: Model<Api>[] = [];
 		for (const item of models) {
 			const id = item.id;
 			if (!id) continue;
+			const referenceModel = resolveCustomModelReference(id);
+			const api = this.#resolveDiscoveredModelApi(providerConfig, id);
 			discovered.push(
 				enrichModelThinking({
 					id,
-					name: id,
-					api: providerConfig.api,
+					name: item.name ?? referenceModel?.name ?? id,
+					api,
 					provider: providerConfig.provider,
 					baseUrl: requestBaseUrl,
-					reasoning: false,
-					input: ["text"],
-					cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-					contextWindow: 128000,
-					maxTokens: 8192,
-					headers,
+					reasoning: referenceModel?.reasoning ?? false,
+					thinking: referenceModel?.thinking,
+					input: referenceModel?.input ?? ["text"],
+					output: referenceModel?.output,
+					cost: referenceModel?.cost ?? { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+					contextWindow: item.context_length ?? referenceModel?.contextWindow ?? UNK_CONTEXT_WINDOW,
+					maxTokens: referenceModel?.maxTokens ?? UNK_MAX_TOKENS,
+					headers: providerConfig.headers,
 					compat: {
+						...referenceModel?.compat,
 						supportsStore: false,
 						supportsDeveloperRole: false,
 						supportsReasoningEffort: false,

packages/coding-agent/src/config/models-config-schema.ts

@@ -189,7 +189,9 @@ export const ModelOverrideSchema = z
 export type ModelOverride = z.infer<typeof ModelOverrideSchema>;
 
 export const ProviderDiscoverySchema = z.object({
-	type: z.enum(["ollama", "llama.cpp", "lm-studio", "openai-models-list"]),
+	type: z.enum(["ollama", "llama.cpp", "lm-studio", "openai-models-list", "models-dev"]),
+	apiByModelPrefix: z.record(z.string().min(1), z.enum(["openai-completions", "anthropic-messages"])).optional(),
+	modelsDevProvider: z.string().min(1).optional(),
 });
 
 const LocalOpenAICompatSchema = z

packages/coding-agent/src/config/provider-ranking.ts

@@ -41,6 +41,8 @@ export const FAMOUS_PROVIDER_ORDER: readonly string[] = [
 	"opencode-go",
 	"zai",
 	"glm-zcode",
+	"cline-pass",
+	"commandcode-goat",
 	"alibaba-token-plan",
 	"qwen-portal",
 	"kimi-code",

packages/coding-agent/src/setup/model-onboarding-guidance.ts

@@ -2,7 +2,7 @@ import { formatProviderCredentialHint } from "@gajae-code/ai/stream";
 
 export const MODEL_ONBOARDING_API_PROVIDER_COMMAND =
 	"/provider add --compat <openai|anthropic> --provider <id> --base-url <url> --api-key-env <ENV> --model <model>";
-export const MODEL_ONBOARDING_PROVIDER_PRESET_COMMAND = "/provider add --preset <minimax|minimax-cn|glm>";
+export const MODEL_ONBOARDING_PROVIDER_PRESET_COMMAND = "/provider add --preset <id>";
 
 export const MODEL_ONBOARDING_SETUP_COMMAND = "gjc setup provider";
 export const MODEL_ONBOARDING_OAUTH_COMMAND = "/provider login [provider-id] or /login [provider-id]";