claude-use 11.24.0 → 11.25.0

package/README.md

@@ -119,6 +119,7 @@ agent-shim provider add <name> --display-name <name> (--base-url <url> | --kind
                                               [--codex-default-model <model>] [--codex-model <tier=model>]... [--codex-effort <none|low|medium|high>] [--codex-login <codex-cli|chatgpt-sign-in>]
 agent-shim provider set <name> [--display-name <name>] ([--base-url <url>] | --kind codex) [--credential <source>]... [--credential-target <bearer|apiKey>] [--env KEY=VALUE]... [--unset-env KEY]... [--json]
                                               [--codex-default-model <model>] [--codex-model <tier=model>]... [--codex-effort <none|low|medium|high>] [--codex-login <codex-cli|chatgpt-sign-in>]
+agent-shim provider add|set <name> [--picker-model <model=tier>]...   # models /model lists beside the tier models; set also takes [--unset-picker-model <model>]...
 agent-shim provider list [--json]
 agent-shim provider show <name> [--json]
 agent-shim provider remove <name> [--yes] [--json]

package/dist/cli.cjs

@@ -26987,7 +26987,7 @@ function isTimeZone(name) {
     return false;
   }
 }
-var import_node_path4, CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, ANTIGRAVITY_TIERS, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_MODEL, ANTIGRAVITY_DEFAULT_TIER_MODELS, ANTIGRAVITY_DEFAULT_EFFORT, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_TIERS, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_LOGIN, CODEX_DEFAULT_MODEL, CODEX_DEFAULT_TIER_MODELS, CODEX_DEFAULT_EFFORT, CodexProviderConfigSchema, ProviderRouteSchema, HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema, ProviderSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, WHOLE_PERCENT_MAX, CompactAtUtilisationSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FRONTDOOR_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
+var import_node_path4, CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, CLAUDE_TIERS, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_MODEL, ANTIGRAVITY_DEFAULT_TIER_MODELS, ANTIGRAVITY_DEFAULT_EFFORT, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_LOGIN, CODEX_DEFAULT_MODEL, CODEX_DEFAULT_TIER_MODELS, CODEX_DEFAULT_EFFORT, CodexProviderConfigSchema, ProviderRouteSchema, PickerModelSchema, PickerModelsSchema, HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema, ProviderSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, WHOLE_PERCENT_MAX, CompactAtUtilisationSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FRONTDOOR_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
 var init_schema = __esm({
   "src/config/schema.ts"() {
     "use strict";
@@ -27088,7 +27088,7 @@ var init_schema = __esm({
     });
     PROVIDER_KINDS = ["http", "codex", "antigravity"];
     ANTIGRAVITY_MODES = ["cloud", "local"];
-    ANTIGRAVITY_TIERS = ["fable", "opus", "sonnet", "haiku"];
+    CLAUDE_TIERS = ["fable", "opus", "sonnet", "haiku"];
     ANTIGRAVITY_EFFORTS = ["none", "low", "medium", "high", "xhigh", "max"];
     ANTIGRAVITY_DEFAULT_MODE = "cloud";
     ANTIGRAVITY_DEFAULT_MODEL = "gemini-3.8-flash-high";
@@ -27105,7 +27105,7 @@ var init_schema = __esm({
       mode: external_exports.enum(ANTIGRAVITY_MODES).optional(),
       /** The model a request maps to when no tier matches its model name. */
       defaultModel: external_exports.string().min(1).optional(),
-      /** Model name mapping. A key naming a tier (`fable`, `opus`, `sonnet`, `haiku`) overrides that tier's shipped model and is matched by substring of the requested name in `ANTIGRAVITY_TIERS` order; any other key is an alias, matched against the whole requested name case-insensitively, so `/model <alias>` selects its backend model. An alias outranks every other rule, including the pass-through of backend names. A value is one model or an ordered list of candidates: the request goes to the first whose quota windows are not spent, and when every candidate is spent, to the one whose binding window lifts soonest. */
+      /** Model name mapping. A key naming a tier (`fable`, `opus`, `sonnet`, `haiku`) overrides that tier's shipped model and is matched by substring of the requested name in `CLAUDE_TIERS` order; any other key is an alias, matched against the whole requested name case-insensitively, so `/model <alias>` selects its backend model. An alias outranks every other rule, including the pass-through of backend names. A value is one model or an ordered list of candidates: the request goes to the first whose quota windows are not spent, and when every candidate is spent, to the one whose binding window lifts soonest. */
       models: external_exports.record(external_exports.string().min(1), AntigravityModelTargetSchema).optional(),
       /** When every candidate of the tier a request names has no quota left, serve it from the next tier down, and onward through the lower tiers, instead of failing with the quota limit. Applies to a name that selects a tier (`/model fable`), not to an alias or a backend model name. Defaults to false. */
       degradeDownTiers: external_exports.boolean().optional(),
@@ -27128,7 +27128,6 @@ var init_schema = __esm({
         socketPath: external_exports.string().min(1).optional()
       }).optional()
     });
-    CODEX_TIERS = ["fable", "opus", "sonnet", "haiku"];
     CODEX_EFFORTS = ["none", "low", "medium", "high"];
     CODEX_LOGINS = ["codex-cli", "chatgpt-sign-in"];
     CODEX_DEFAULT_LOGIN = "codex-cli";
@@ -27143,7 +27142,7 @@ var init_schema = __esm({
     CodexProviderConfigSchema = external_exports.strictObject({
       /** The codex model a request maps to when no tier matches its model name. */
       defaultModel: external_exports.string().min(1).optional(),
-      /** Per-tier overrides of the shipped mapping, matched by substring of the requested model name in `CODEX_TIERS` order. */
+      /** Per-tier overrides of the shipped mapping, matched by substring of the requested model name in `CLAUDE_TIERS` order. */
       models: external_exports.strictObject({
         fable: external_exports.string().min(1).optional(),
         opus: external_exports.string().min(1).optional(),
@@ -27163,6 +27162,13 @@ var init_schema = __esm({
       /** The model name to rewrite the request to before it reaches the target, for a provider that expects another form (OpenRouter's `anthropic/claude-...` for instance). A route that rewrites reads the whole body, the one copy the rewrite needs. */
       model: external_exports.string().min(1).optional()
     });
+    PickerModelSchema = external_exports.strictObject({
+      model: external_exports.string().min(1),
+      tier: external_exports.enum(CLAUDE_TIERS),
+      label: external_exports.string().min(1).optional(),
+      description: external_exports.string().min(1).optional()
+    });
+    PickerModelsSchema = external_exports.array(PickerModelSchema).refine((models) => new Set(models.map((entry) => entry.model)).size === models.length, { message: "pickerModels names a model more than once" });
     HttpProviderSchema = external_exports.strictObject({
       $schema: external_exports.string().optional(),
       kind: external_exports.literal("http").optional(),
@@ -27170,6 +27176,8 @@ var init_schema = __esm({
       baseUrl: external_exports.url(),
       credential: ProviderCredentialSchema,
       env: ProviderEnvSchema.optional(),
+      /** Extra models `/model` lists beside the ones the tier settings name. */
+      pickerModels: PickerModelsSchema.optional(),
       /** Per-request routing: when present, each request this provider would serve is matched against the list in order, and the first definite match is sent to that entry's provider instead (itself resolved exactly as a directly dialled request would be). Unmatched requests stay on this provider. */
       routes: external_exports.array(ProviderRouteSchema).optional()
     });
@@ -27179,6 +27187,8 @@ var init_schema = __esm({
       displayName: external_exports.string().min(1),
       credential: ProviderCredentialSchema,
       env: ProviderEnvSchema.optional(),
+      /** Extra models `/model` lists beside the ones the tier settings name. */
+      pickerModels: PickerModelsSchema.optional(),
       codex: CodexProviderConfigSchema.optional()
     });
     AntigravityProviderSchema = external_exports.strictObject({
@@ -27187,6 +27197,8 @@ var init_schema = __esm({
       displayName: external_exports.string().min(1),
       credential: ProviderCredentialSchema,
       env: ProviderEnvSchema.optional(),
+      /** Extra models `/model` lists beside the ones the tier settings name. */
+      pickerModels: PickerModelsSchema.optional(),
       antigravity: AntigravityProviderConfigSchema.optional()
     });
     ProviderSchema = external_exports.discriminatedUnion("kind", [HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema]);
@@ -34181,7 +34193,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.24.0",
+      version: "11.25.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -35892,7 +35904,8 @@ function addProvider(paths, name, input2) {
   const shared = {
     displayName: input2.displayName,
     credential: { sources: input2.sources, ...input2.target === void 0 ? {} : { target: input2.target } },
-    ...input2.env === void 0 || Object.keys(input2.env).length === 0 ? {} : { env: input2.env }
+    ...input2.env === void 0 || Object.keys(input2.env).length === 0 ? {} : { env: input2.env },
+    ...input2.pickerModels === void 0 || input2.pickerModels.length === 0 ? {} : { pickerModels: input2.pickerModels }
   };
   const parsed = ProviderSchema.safeParse(
     kind === "codex" ? { kind, ...shared, ...isEmptyCodexConfig(input2.codex) ? {} : { codex: input2.codex } } : kind === "antigravity" ? { kind, ...shared, ...isEmptyAntigravityConfig(input2.antigravity) ? {} : { antigravity: input2.antigravity } } : { ...shared, baseUrl: input2.baseUrl }
@@ -35910,6 +35923,12 @@ function updateProvider(paths, name, input2) {
   }
   const unset = new Set(input2.unsetEnv);
   const env = Object.fromEntries(Object.entries({ ...existing.env, ...input2.env }).filter(([key]) => !unset.has(key)));
+  const unsetPicker = new Set(input2.unsetPickerModels);
+  const added = new Map((input2.pickerModels ?? []).map((entry) => [entry.model, entry]));
+  const pickerModels = [
+    ...(existing.pickerModels ?? []).filter((entry) => !unsetPicker.has(entry.model)).map((entry) => added.get(entry.model) ?? entry),
+    ...[...added.values()].filter((entry) => !(existing.pickerModels ?? []).some((kept) => kept.model === entry.model))
+  ];
   const target = input2.target ?? existing.credential.target;
   const cache = input2.cache === void 0 ? existing.credential.cache : input2.cache === false ? void 0 : input2.cache;
   if (isCodexProvider(existing) && input2.baseUrl !== void 0) {
@@ -35931,7 +35950,8 @@ function updateProvider(paths, name, input2) {
       ...target === void 0 ? {} : { target },
       ...cache === void 0 ? {} : { cache }
     },
-    env: Object.keys(env).length === 0 ? void 0 : env
+    env: Object.keys(env).length === 0 ? void 0 : env,
+    pickerModels: pickerModels.length === 0 ? void 0 : pickerModels
   };
   let candidate;
   if (isCodexProvider(existing)) {
@@ -63920,7 +63940,7 @@ function candidatesOf(target) {
   return typeof target === "string" ? [target] : target;
 }
 function isAntigravityTier(key) {
-  return ANTIGRAVITY_TIERS.some((tier) => tier === key);
+  return CLAUDE_TIERS.some((tier) => tier === key);
 }
 function resolveAntigravityConfig(config2) {
   const overrides = config2?.models ?? {};
@@ -63965,7 +63985,7 @@ function resolveName(requested, config2) {
   if (isBackendModelName(stripped)) {
     return { candidates: [stripped], tier: void 0 };
   }
-  const tier = ANTIGRAVITY_TIERS.find((candidate) => lower.includes(candidate));
+  const tier = CLAUDE_TIERS.find((candidate) => lower.includes(candidate));
   return tier === void 0 ? { candidates: [config2.defaultModel], tier: void 0 } : { candidates: config2.models[tier], tier };
 }
 function candidateStages(requested, config2) {
@@ -63973,7 +63993,7 @@ function candidateStages(requested, config2) {
   if (!config2.degradeDownTiers || tier === void 0) {
     return [candidates];
   }
-  return ANTIGRAVITY_TIERS.slice(ANTIGRAVITY_TIERS.indexOf(tier)).map((name) => config2.models[name]);
+  return CLAUDE_TIERS.slice(CLAUDE_TIERS.indexOf(tier)).map((name) => config2.models[name]);
 }
 function chooseCandidate(candidates, routing) {
   const first = candidates[0];
@@ -64249,7 +64269,7 @@ function mapModel(requested, config2) {
     return requested;
   }
   const lower = requested.toLowerCase();
-  const tier = CODEX_TIERS.find((candidate) => lower.includes(candidate));
+  const tier = CLAUDE_TIERS.find((candidate) => lower.includes(candidate));
   return tier === void 0 ? config2.defaultModel : config2.models[tier];
 }
 function isRequestableEffort(value2) {
@@ -64408,6 +64428,12 @@ var init_translate2 = __esm({
 });
 
 // src/launcher/modelPicker.ts
+function labelOf(model) {
+  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M2) ? model.slice(0, -CONTEXT_MARKER_1M2.length) : model;
+}
+function describedAs(model, description) {
+  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M2) ? `${description}; 1M context` : description;
+}
 function joined(parts) {
   const last = parts[parts.length - 1];
   return last === void 0 || parts.length === 1 ? last ?? "" : `${parts.slice(0, -1).join(", ")} and ${last}`;
@@ -64421,7 +64447,7 @@ function rowOf(model, reaches) {
   const fallbacks = reaches.filter((reach) => reach.standing === "fallback").map((reach) => reach.tier);
   const serves = firsts.length === 0 ? [] : [`Serves the ${joined(firsts)} tier${firsts.length === 1 ? "" : "s"}`];
   const falls = fallbacks.length === 0 ? [] : [`${serves.length === 0 ? "Fallback" : "fallback"} for ${joined(fallbacks)}`];
-  return { model, label: model, description: [...serves, ...falls].join("; "), behavesAs: TIER_BEHAVES_AS[lead.tier] };
+  return { model, label: labelOf(model), description: describedAs(model, [...serves, ...falls].join("; ")), behavesAs: TIER_BEHAVES_AS[lead.tier] };
 }
 function rowsOfTable(table) {
   const reachesByModel = /* @__PURE__ */ new Map();
@@ -64438,47 +64464,53 @@ function rowsOfTable(table) {
 }
 function antigravityRows(provider) {
   const config2 = resolveAntigravityConfig(provider.antigravity);
-  const tiers = rowsOfTable(ANTIGRAVITY_TIERS.map((tier) => [tier, config2.models[tier]]));
+  const tiers = rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, config2.models[tier]]));
   const behavesAsOf = new Map(tiers.map((row) => [row.model, row.behavesAs]));
   const aliases = [...config2.aliases].flatMap(([alias, candidates]) => {
     const [first] = candidates;
     const behavesAs = first === void 0 ? void 0 : behavesAsOf.get(first);
-    return behavesAs === void 0 ? [] : [{ model: alias, label: alias, description: `Alias for ${candidates.join(", then ")}`, behavesAs }];
+    return behavesAs === void 0 ? [] : [{ model: alias, label: labelOf(alias), description: `Alias for ${candidates.join(", then ")}`, behavesAs }];
   });
   return [...tiers, ...aliases];
 }
 function codexRows(provider) {
   const config2 = resolveCodexConfig(provider.codex);
-  return rowsOfTable(CODEX_TIERS.map((tier) => [tier, [config2.models[tier]]]));
+  return rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, [config2.models[tier]]]));
 }
 function httpRows(provider) {
   const env = provider.env ?? {};
-  const table = CODEX_TIERS.flatMap((tier) => {
+  const table = CLAUDE_TIERS.flatMap((tier) => {
     const model = env[TIER_ENV_VARIABLES[tier]];
     return model === void 0 || model === "" ? [] : [[tier, [model]]];
   });
   return rowsOfTable(table);
 }
+function declaredRow(entry) {
+  return {
+    model: entry.model,
+    label: entry.label ?? labelOf(entry.model),
+    description: entry.description ?? describedAs(entry.model, `Declared by the provider for the ${entry.tier} tier`),
+    behavesAs: TIER_BEHAVES_AS[entry.tier]
+  };
+}
 function providerModelRows(provider) {
-  if (provider.kind === "codex") {
-    return codexRows(provider);
-  }
-  if (provider.kind === "antigravity") {
-    return antigravityRows(provider);
-  }
-  return httpRows(provider);
+  const derived2 = provider.kind === "codex" ? codexRows(provider) : provider.kind === "antigravity" ? antigravityRows(provider) : httpRows(provider);
+  const declared = (provider.pickerModels ?? []).map(declaredRow);
+  const declaredModels = new Set(declared.map((row) => row.model));
+  return [...derived2.filter((row) => !declaredModels.has(row.model)), ...declared];
 }
 function modelPickerSettings(provider) {
   const options = providerModelRows(provider);
   return options.length === 0 ? void 0 : JSON.stringify({ modelPicker: { options, replaceBuiltInOptions: true } });
 }
-var TIER_BEHAVES_AS, TIER_ENV_VARIABLES;
+var CONTEXT_MARKER_1M2, TIER_BEHAVES_AS, TIER_ENV_VARIABLES;
 var init_modelPicker = __esm({
   "src/launcher/modelPicker.ts"() {
     "use strict";
     init_translate();
     init_translate2();
     init_schema();
+    CONTEXT_MARKER_1M2 = "[1m]";
     TIER_BEHAVES_AS = Object.freeze({
       fable: "claude-fable-5-1",
       opus: "claude-opus-5-5",
@@ -145733,7 +145765,8 @@ function toProviderView(name, provider) {
     displayName: provider.displayName,
     ...isCodexProvider(provider) ? provider.codex === void 0 ? {} : { codex: provider.codex } : isAntigravityProvider(provider) ? provider.antigravity === void 0 ? {} : { antigravity: provider.antigravity } : { baseUrl: provider.baseUrl },
     credential: summariseCredential(provider.credential),
-    ...provider.env === void 0 ? {} : { env: provider.env }
+    ...provider.env === void 0 ? {} : { env: provider.env },
+    ...provider.pickerModels === void 0 ? {} : { pickerModels: provider.pickerModels }
   };
 }
 function antigravityConfigFromOptions(options) {
@@ -145764,6 +145797,15 @@ function antigravityConfigFromOptions(options) {
   }
   return parsed.data;
 }
+function pickerModelsFromOption(option) {
+  return Object.entries(option).map(([model, tier]) => {
+    const parsed = PickerModelSchema.safeParse({ model, tier });
+    if (!parsed.success) {
+      throw new UsageError(`Invalid --picker-model ${model}=${tier}: ${parsed.error.issues.map((issue2) => `${issue2.path.join(".")}: ${issue2.message}`).join("; ")}`);
+    }
+    return parsed.data;
+  });
+}
 function codexConfigFromOptions(options) {
   if (options.codexDefaultModel === void 0 && options.codexModel === void 0 && options.codexEffort === void 0 && options.codexLogin === void 0) {
     return void 0;
@@ -145795,7 +145837,7 @@ function registerProviderCommand(program2, deps) {
       new Option("--credential-target <target>", "Where the token goes: bearer sets ANTHROPIC_AUTH_TOKEN (default), apiKey sets ANTHROPIC_API_KEY.").choices(
         PROVIDER_CREDENTIAL_TARGETS
       )
-    ).option("--env <KEY=VALUE>", "Extra environment entry for the child (repeatable).", collectStringPair).option("--codex-default-model <model>", "Codex providers: the codex model a request maps to when no tier matches.").option("--codex-model <tier=model>", "Codex providers: the codex model one tier (fable, opus, sonnet or haiku) maps to (repeatable).", collectStringPair).addOption(new Option("--codex-effort <effort>", "Codex providers: the reasoning effort when a request asks for none the backend accepts.").choices(CODEX_EFFORTS)).addOption(new Option("--codex-login <login>", "Codex providers: which login the upstream call uses, the Codex CLI's own login or a Sign in with ChatGPT grant from `agent-shim codex login`.").choices(CODEX_LOGINS)).addOption(new Option("--antigravity-mode <mode>", "Antigravity providers: cloud (direct Gemini/Vertex) or local (ACP daemon).").choices(ANTIGRAVITY_MODES)).option("--antigravity-default-model <model>", "Antigravity providers: the model a request maps to when no tier matches.").option("--antigravity-model <tier=model>", "Antigravity providers: the model a tier (fable, opus, sonnet or haiku, matched by substring) or an alias (any other name, matched whole, selectable with /model) maps to; a comma-separated list routes by available quota, first unspent first (repeatable).", collectStringPair).addOption(new Option("--antigravity-effort <effort>", "Antigravity providers: reasoning effort.").choices(ANTIGRAVITY_EFFORTS)).option("--antigravity-degrade-down-tiers", "Antigravity providers: when every candidate of a tier has no quota left, serve the request from the tiers below it instead of failing.").option("--no-antigravity-degrade-down-tiers", "Antigravity providers: fail with the quota limit when a tier has no quota left (the default).").option("--antigravity-endpoint <url>", "Antigravity cloud providers: custom API endpoint URL.").option("--antigravity-project-id <id>", "Antigravity cloud providers: Google Cloud project ID (for Vertex AI).").option("--antigravity-location <loc>", "Antigravity cloud providers: Google Cloud location (for Vertex AI).").option("--antigravity-command <cmd...>", "Antigravity local providers: command to spawn ACP server.", collectRepeated).option("--antigravity-socket <path>", "Antigravity local providers: path to existing Unix domain socket.").option("--json", "Print the result as JSON.").action((name, options) => {
+    ).option("--env <KEY=VALUE>", "Extra environment entry for the child (repeatable).", collectStringPair).option("--picker-model <model=tier>", "A model /model lists beside the ones the tier settings name, with the Claude tier (fable, opus, sonnet or haiku) whose handling it borrows (repeatable).", collectStringPair).option("--codex-default-model <model>", "Codex providers: the codex model a request maps to when no tier matches.").option("--codex-model <tier=model>", "Codex providers: the codex model one tier (fable, opus, sonnet or haiku) maps to (repeatable).", collectStringPair).addOption(new Option("--codex-effort <effort>", "Codex providers: the reasoning effort when a request asks for none the backend accepts.").choices(CODEX_EFFORTS)).addOption(new Option("--codex-login <login>", "Codex providers: which login the upstream call uses, the Codex CLI's own login or a Sign in with ChatGPT grant from `agent-shim codex login`.").choices(CODEX_LOGINS)).addOption(new Option("--antigravity-mode <mode>", "Antigravity providers: cloud (direct Gemini/Vertex) or local (ACP daemon).").choices(ANTIGRAVITY_MODES)).option("--antigravity-default-model <model>", "Antigravity providers: the model a request maps to when no tier matches.").option("--antigravity-model <tier=model>", "Antigravity providers: the model a tier (fable, opus, sonnet or haiku, matched by substring) or an alias (any other name, matched whole, selectable with /model) maps to; a comma-separated list routes by available quota, first unspent first (repeatable).", collectStringPair).addOption(new Option("--antigravity-effort <effort>", "Antigravity providers: reasoning effort.").choices(ANTIGRAVITY_EFFORTS)).option("--antigravity-degrade-down-tiers", "Antigravity providers: when every candidate of a tier has no quota left, serve the request from the tiers below it instead of failing.").option("--no-antigravity-degrade-down-tiers", "Antigravity providers: fail with the quota limit when a tier has no quota left (the default).").option("--antigravity-endpoint <url>", "Antigravity cloud providers: custom API endpoint URL.").option("--antigravity-project-id <id>", "Antigravity cloud providers: Google Cloud project ID (for Vertex AI).").option("--antigravity-location <loc>", "Antigravity cloud providers: Google Cloud location (for Vertex AI).").option("--antigravity-command <cmd...>", "Antigravity local providers: command to spawn ACP server.", collectRepeated).option("--antigravity-socket <path>", "Antigravity local providers: path to existing Unix domain socket.").option("--json", "Print the result as JSON.").action((name, options) => {
       const codex = codexConfigFromOptions(options);
       const antigravity = antigravityConfigFromOptions(options);
       const created = addProvider(paths, name, {
@@ -145805,6 +145847,7 @@ function registerProviderCommand(program2, deps) {
         sources: options.credential,
         ...options.credentialTarget === void 0 ? {} : { target: options.credentialTarget },
         ...options.env === void 0 ? {} : { env: options.env },
+        ...options.pickerModel === void 0 ? {} : { pickerModels: pickerModelsFromOption(options.pickerModel) },
         ...codex === void 0 ? {} : { codex },
         ...antigravity === void 0 ? {} : { antigravity }
       });
@@ -145831,14 +145874,14 @@ function registerProviderCommand(program2, deps) {
     new Option("--credential-target <target>", "Where the token goes: bearer sets ANTHROPIC_AUTH_TOKEN, apiKey sets ANTHROPIC_API_KEY.").choices(
       PROVIDER_CREDENTIAL_TARGETS
     )
-  ).option("--env <KEY=VALUE>", "Add or replace an environment entry for the child (repeatable).", collectStringPair).option("--unset-env <KEY>", "Remove an environment entry (repeatable).", collectRepeated).option("--codex-default-model <model>", "Codex providers: replace the model a request maps to when no tier matches.").option("--codex-model <tier=model>", "Codex providers: set the codex model one tier maps to (repeatable; other tiers are kept).", collectStringPair).addOption(new Option("--codex-effort <effort>", "Codex providers: replace the default reasoning effort.").choices(CODEX_EFFORTS)).addOption(new Option("--codex-login <login>", "Codex providers: replace which login the upstream call uses.").choices(CODEX_LOGINS)).addOption(new Option("--antigravity-mode <mode>", "Antigravity providers: cloud (direct Gemini/Vertex) or local (ACP daemon).").choices(ANTIGRAVITY_MODES)).option("--antigravity-default-model <model>", "Antigravity providers: the model a request maps to when no tier matches.").option("--antigravity-model <tier=model>", "Antigravity providers: set the model one tier maps to (repeatable; other tiers are kept).", collectStringPair).addOption(new Option("--antigravity-effort <effort>", "Antigravity providers: reasoning effort.").choices(ANTIGRAVITY_EFFORTS)).option("--antigravity-degrade-down-tiers", "Antigravity providers: when every candidate of a tier has no quota left, serve the request from the tiers below it instead of failing.").option("--no-antigravity-degrade-down-tiers", "Antigravity providers: fail with the quota limit when a tier has no quota left (the default).").option("--antigravity-endpoint <url>", "Antigravity cloud providers: custom API endpoint URL.").option("--antigravity-project-id <id>", "Antigravity cloud providers: Google Cloud project ID (for Vertex AI).").option("--antigravity-location <loc>", "Antigravity cloud providers: Google Cloud location (for Vertex AI).").option("--antigravity-command <cmd...>", "Antigravity local providers: command to spawn ACP server.", collectRepeated).option("--antigravity-socket <path>", "Antigravity local providers: path to existing Unix domain socket.");
+  ).option("--env <KEY=VALUE>", "Add or replace an environment entry for the child (repeatable).", collectStringPair).option("--unset-env <KEY>", "Remove an environment entry (repeatable).", collectRepeated).option("--picker-model <model=tier>", "Add or replace a model /model lists beside the ones the tier settings name, with the Claude tier (fable, opus, sonnet or haiku) whose handling it borrows (repeatable).", collectStringPair).option("--unset-picker-model <model>", "Remove a model from the /model list (repeatable).", collectRepeated).option("--codex-default-model <model>", "Codex providers: replace the model a request maps to when no tier matches.").option("--codex-model <tier=model>", "Codex providers: set the codex model one tier maps to (repeatable; other tiers are kept).", collectStringPair).addOption(new Option("--codex-effort <effort>", "Codex providers: replace the default reasoning effort.").choices(CODEX_EFFORTS)).addOption(new Option("--codex-login <login>", "Codex providers: replace which login the upstream call uses.").choices(CODEX_LOGINS)).addOption(new Option("--antigravity-mode <mode>", "Antigravity providers: cloud (direct Gemini/Vertex) or local (ACP daemon).").choices(ANTIGRAVITY_MODES)).option("--antigravity-default-model <model>", "Antigravity providers: the model a request maps to when no tier matches.").option("--antigravity-model <tier=model>", "Antigravity providers: set the model one tier maps to (repeatable; other tiers are kept).", collectStringPair).addOption(new Option("--antigravity-effort <effort>", "Antigravity providers: reasoning effort.").choices(ANTIGRAVITY_EFFORTS)).option("--antigravity-degrade-down-tiers", "Antigravity providers: when every candidate of a tier has no quota left, serve the request from the tiers below it instead of failing.").option("--no-antigravity-degrade-down-tiers", "Antigravity providers: fail with the quota limit when a tier has no quota left (the default).").option("--antigravity-endpoint <url>", "Antigravity cloud providers: custom API endpoint URL.").option("--antigravity-project-id <id>", "Antigravity cloud providers: Google Cloud project ID (for Vertex AI).").option("--antigravity-location <loc>", "Antigravity cloud providers: Google Cloud location (for Vertex AI).").option("--antigravity-command <cmd...>", "Antigravity local providers: command to spawn ACP server.", collectRepeated).option("--antigravity-socket <path>", "Antigravity local providers: path to existing Unix domain socket.");
   addCredentialCacheOptions(providerSet);
   withExamples(
     providerSet.option("--json", "Print the result as JSON.").action((name, allOptions) => {
       const { json: json2, ...options } = allOptions;
       if (Object.entries(allOptions).every(([key, value2]) => key === "json" || value2 === void 0)) {
         throw new UsageError(
-          "Nothing to change: pass --display-name, --base-url, --credential, --credential-target, a --credential-cache option, --env, --unset-env, or codex/antigravity settings."
+          "Nothing to change: pass --display-name, --base-url, --credential, --credential-target, a --credential-cache option, --env, --unset-env, --picker-model, --unset-picker-model, or codex/antigravity settings."
         );
       }
       const codex = codexConfigFromOptions(options);
@@ -145853,7 +145896,9 @@ function registerProviderCommand(program2, deps) {
         ...options.credential === void 0 ? {} : { sources: options.credential },
         ...options.credentialTarget === void 0 ? {} : { target: options.credentialTarget },
         ...options.env === void 0 ? {} : { env: options.env },
-        ...options.unsetEnv === void 0 ? {} : { unsetEnv: options.unsetEnv }
+        ...options.unsetEnv === void 0 ? {} : { unsetEnv: options.unsetEnv },
+        ...options.pickerModel === void 0 ? {} : { pickerModels: pickerModelsFromOption(options.pickerModel) },
+        ...options.unsetPickerModel === void 0 ? {} : { unsetPickerModels: options.unsetPickerModel }
       });
       reportMutation(json2, { action: "updated", kind: "provider", name, value: updated }, () => {
         console.log(`Updated provider "${name}" (${describeProviderEndpoint(updated)}, credential ${describeCredential(updated.credential)}).`);
@@ -145865,7 +145910,8 @@ function registerProviderCommand(program2, deps) {
       "agent-shim provider set z --credential op:op://vault/z/credential --credential-cache-ttl 12h",
       "agent-shim provider set anthropic-api --credential-target apiKey",
       "agent-shim provider set codex --codex-model haiku=gpt-5.6-terra",
-      "agent-shim provider set agy --antigravity-model haiku=gemini-2.5-flash"
+      "agent-shim provider set agy --antigravity-model haiku=gemini-2.5-flash",
+      "agent-shim provider set o --picker-model deepseek/deepseek-r1=opus --picker-model qwen/qwen3-coder=sonnet"
     ]
   );
   withExamples(
@@ -145900,13 +145946,13 @@ function registerProviderCommand(program2, deps) {
       console.log(`Kind: ${found.kind ?? "http"}`);
       if (isCodexProvider(found)) {
         const config2 = resolveCodexConfig(found.codex);
-        console.log(`Codex models: ${CODEX_TIERS.map((tier) => `${tier}=${config2.models[tier]}`).join(", ")}, otherwise ${config2.defaultModel}`);
+        console.log(`Codex models: ${CLAUDE_TIERS.map((tier) => `${tier}=${config2.models[tier]}`).join(", ")}, otherwise ${config2.defaultModel}`);
         console.log(`Codex effort: ${config2.effort}`);
         console.log(`Codex login: ${config2.login}`);
       } else if (isAntigravityProvider(found)) {
         const config2 = resolveAntigravityConfig(found.antigravity);
         console.log(`Antigravity mode: ${config2.mode}`);
-        console.log(`Antigravity models: ${ANTIGRAVITY_TIERS.map((tier) => `${tier}=${config2.models[tier].join(" > ")}`).join(", ")}, otherwise ${config2.defaultModel}`);
+        console.log(`Antigravity models: ${CLAUDE_TIERS.map((tier) => `${tier}=${config2.models[tier].join(" > ")}`).join(", ")}, otherwise ${config2.defaultModel}`);
         if (config2.aliases.size > 0) {
           console.log(`Antigravity aliases: ${[...config2.aliases].map(([alias, model]) => `${alias}=${model.join(" > ")}`).join(", ")}`);
         }
@@ -145919,6 +145965,9 @@ function registerProviderCommand(program2, deps) {
       console.log(`Credential: ${describeCredential(found.credential)}`);
       const env = Object.entries(found.env ?? {});
       console.log(`Environment: ${env.length === 0 ? "(none)" : env.map(([key, value2]) => `${key}=${value2}`).join(", ")}`);
+      if (found.pickerModels !== void 0) {
+        console.log(`Picker models: ${found.pickerModels.map((entry) => `${entry.model} (${entry.tier})`).join(", ")}`);
+      }
     }),
     ["agent-shim provider show z", "agent-shim provider show z --json"]
   );

package/dist/index.cjs

@@ -242,7 +242,7 @@ function isTimeZone(name) {
     return false;
   }
 }
-var import_node_path2, import_zod, import_trilean, CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, ANTIGRAVITY_TIERS, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_MODEL, ANTIGRAVITY_DEFAULT_TIER_MODELS, ANTIGRAVITY_DEFAULT_EFFORT, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_TIERS, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_LOGIN, CODEX_DEFAULT_MODEL, CODEX_DEFAULT_TIER_MODELS, CODEX_DEFAULT_EFFORT, CodexProviderConfigSchema, ProviderRouteSchema, HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema, ProviderSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, WHOLE_PERCENT_MAX, CompactAtUtilisationSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
+var import_node_path2, import_zod, import_trilean, CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, CLAUDE_TIERS, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_MODEL, ANTIGRAVITY_DEFAULT_TIER_MODELS, ANTIGRAVITY_DEFAULT_EFFORT, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_LOGIN, CODEX_DEFAULT_MODEL, CODEX_DEFAULT_TIER_MODELS, CODEX_DEFAULT_EFFORT, CodexProviderConfigSchema, ProviderRouteSchema, PickerModelSchema, PickerModelsSchema, HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema, ProviderSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, WHOLE_PERCENT_MAX, CompactAtUtilisationSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
 var init_schema = __esm({
   "src/config/schema.ts"() {
     "use strict";
@@ -343,7 +343,7 @@ var init_schema = __esm({
     });
     PROVIDER_KINDS = ["http", "codex", "antigravity"];
     ANTIGRAVITY_MODES = ["cloud", "local"];
-    ANTIGRAVITY_TIERS = ["fable", "opus", "sonnet", "haiku"];
+    CLAUDE_TIERS = ["fable", "opus", "sonnet", "haiku"];
     ANTIGRAVITY_EFFORTS = ["none", "low", "medium", "high", "xhigh", "max"];
     ANTIGRAVITY_DEFAULT_MODE = "cloud";
     ANTIGRAVITY_DEFAULT_MODEL = "gemini-3.8-flash-high";
@@ -360,7 +360,7 @@ var init_schema = __esm({
       mode: import_zod.z.enum(ANTIGRAVITY_MODES).optional(),
       /** The model a request maps to when no tier matches its model name. */
       defaultModel: import_zod.z.string().min(1).optional(),
-      /** Model name mapping. A key naming a tier (`fable`, `opus`, `sonnet`, `haiku`) overrides that tier's shipped model and is matched by substring of the requested name in `ANTIGRAVITY_TIERS` order; any other key is an alias, matched against the whole requested name case-insensitively, so `/model <alias>` selects its backend model. An alias outranks every other rule, including the pass-through of backend names. A value is one model or an ordered list of candidates: the request goes to the first whose quota windows are not spent, and when every candidate is spent, to the one whose binding window lifts soonest. */
+      /** Model name mapping. A key naming a tier (`fable`, `opus`, `sonnet`, `haiku`) overrides that tier's shipped model and is matched by substring of the requested name in `CLAUDE_TIERS` order; any other key is an alias, matched against the whole requested name case-insensitively, so `/model <alias>` selects its backend model. An alias outranks every other rule, including the pass-through of backend names. A value is one model or an ordered list of candidates: the request goes to the first whose quota windows are not spent, and when every candidate is spent, to the one whose binding window lifts soonest. */
       models: import_zod.z.record(import_zod.z.string().min(1), AntigravityModelTargetSchema).optional(),
       /** When every candidate of the tier a request names has no quota left, serve it from the next tier down, and onward through the lower tiers, instead of failing with the quota limit. Applies to a name that selects a tier (`/model fable`), not to an alias or a backend model name. Defaults to false. */
       degradeDownTiers: import_zod.z.boolean().optional(),
@@ -383,7 +383,6 @@ var init_schema = __esm({
         socketPath: import_zod.z.string().min(1).optional()
       }).optional()
     });
-    CODEX_TIERS = ["fable", "opus", "sonnet", "haiku"];
     CODEX_EFFORTS = ["none", "low", "medium", "high"];
     CODEX_LOGINS = ["codex-cli", "chatgpt-sign-in"];
     CODEX_DEFAULT_LOGIN = "codex-cli";
@@ -398,7 +397,7 @@ var init_schema = __esm({
     CodexProviderConfigSchema = import_zod.z.strictObject({
       /** The codex model a request maps to when no tier matches its model name. */
       defaultModel: import_zod.z.string().min(1).optional(),
-      /** Per-tier overrides of the shipped mapping, matched by substring of the requested model name in `CODEX_TIERS` order. */
+      /** Per-tier overrides of the shipped mapping, matched by substring of the requested model name in `CLAUDE_TIERS` order. */
       models: import_zod.z.strictObject({
         fable: import_zod.z.string().min(1).optional(),
         opus: import_zod.z.string().min(1).optional(),
@@ -418,6 +417,13 @@ var init_schema = __esm({
       /** The model name to rewrite the request to before it reaches the target, for a provider that expects another form (OpenRouter's `anthropic/claude-...` for instance). A route that rewrites reads the whole body, the one copy the rewrite needs. */
       model: import_zod.z.string().min(1).optional()
     });
+    PickerModelSchema = import_zod.z.strictObject({
+      model: import_zod.z.string().min(1),
+      tier: import_zod.z.enum(CLAUDE_TIERS),
+      label: import_zod.z.string().min(1).optional(),
+      description: import_zod.z.string().min(1).optional()
+    });
+    PickerModelsSchema = import_zod.z.array(PickerModelSchema).refine((models) => new Set(models.map((entry) => entry.model)).size === models.length, { message: "pickerModels names a model more than once" });
     HttpProviderSchema = import_zod.z.strictObject({
       $schema: import_zod.z.string().optional(),
       kind: import_zod.z.literal("http").optional(),
@@ -425,6 +431,8 @@ var init_schema = __esm({
       baseUrl: import_zod.z.url(),
       credential: ProviderCredentialSchema,
       env: ProviderEnvSchema.optional(),
+      /** Extra models `/model` lists beside the ones the tier settings name. */
+      pickerModels: PickerModelsSchema.optional(),
       /** Per-request routing: when present, each request this provider would serve is matched against the list in order, and the first definite match is sent to that entry's provider instead (itself resolved exactly as a directly dialled request would be). Unmatched requests stay on this provider. */
       routes: import_zod.z.array(ProviderRouteSchema).optional()
     });
@@ -434,6 +442,8 @@ var init_schema = __esm({
       displayName: import_zod.z.string().min(1),
       credential: ProviderCredentialSchema,
       env: ProviderEnvSchema.optional(),
+      /** Extra models `/model` lists beside the ones the tier settings name. */
+      pickerModels: PickerModelsSchema.optional(),
       codex: CodexProviderConfigSchema.optional()
     });
     AntigravityProviderSchema = import_zod.z.strictObject({
@@ -442,6 +452,8 @@ var init_schema = __esm({
       displayName: import_zod.z.string().min(1),
       credential: ProviderCredentialSchema,
       env: ProviderEnvSchema.optional(),
+      /** Extra models `/model` lists beside the ones the tier settings name. */
+      pickerModels: PickerModelsSchema.optional(),
       antigravity: AntigravityProviderConfigSchema.optional()
     });
     ProviderSchema = import_zod.z.discriminatedUnion("kind", [HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema]);
@@ -2935,7 +2947,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.24.0",
+      version: "11.25.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -6562,7 +6574,8 @@ function addProvider(paths, name, input) {
   const shared = {
     displayName: input.displayName,
     credential: { sources: input.sources, ...input.target === void 0 ? {} : { target: input.target } },
-    ...input.env === void 0 || Object.keys(input.env).length === 0 ? {} : { env: input.env }
+    ...input.env === void 0 || Object.keys(input.env).length === 0 ? {} : { env: input.env },
+    ...input.pickerModels === void 0 || input.pickerModels.length === 0 ? {} : { pickerModels: input.pickerModels }
   };
   const parsed = ProviderSchema.safeParse(
     kind === "codex" ? { kind, ...shared, ...isEmptyCodexConfig(input.codex) ? {} : { codex: input.codex } } : kind === "antigravity" ? { kind, ...shared, ...isEmptyAntigravityConfig(input.antigravity) ? {} : { antigravity: input.antigravity } } : { ...shared, baseUrl: input.baseUrl }
@@ -6580,6 +6593,12 @@ function updateProvider(paths, name, input) {
   }
   const unset = new Set(input.unsetEnv);
   const env = Object.fromEntries(Object.entries({ ...existing.env, ...input.env }).filter(([key]) => !unset.has(key)));
+  const unsetPicker = new Set(input.unsetPickerModels);
+  const added = new Map((input.pickerModels ?? []).map((entry) => [entry.model, entry]));
+  const pickerModels = [
+    ...(existing.pickerModels ?? []).filter((entry) => !unsetPicker.has(entry.model)).map((entry) => added.get(entry.model) ?? entry),
+    ...[...added.values()].filter((entry) => !(existing.pickerModels ?? []).some((kept) => kept.model === entry.model))
+  ];
   const target = input.target ?? existing.credential.target;
   const cache = input.cache === void 0 ? existing.credential.cache : input.cache === false ? void 0 : input.cache;
   if (isCodexProvider(existing) && input.baseUrl !== void 0) {
@@ -6601,7 +6620,8 @@ function updateProvider(paths, name, input) {
       ...target === void 0 ? {} : { target },
       ...cache === void 0 ? {} : { cache }
     },
-    env: Object.keys(env).length === 0 ? void 0 : env
+    env: Object.keys(env).length === 0 ? void 0 : env,
+    pickerModels: pickerModels.length === 0 ? void 0 : pickerModels
   };
   let candidate;
   if (isCodexProvider(existing)) {
@@ -7947,7 +7967,7 @@ function candidatesOf(target) {
   return typeof target === "string" ? [target] : target;
 }
 function isAntigravityTier(key) {
-  return ANTIGRAVITY_TIERS.some((tier) => tier === key);
+  return CLAUDE_TIERS.some((tier) => tier === key);
 }
 function resolveAntigravityConfig(config) {
   const overrides = config?.models ?? {};
@@ -8013,6 +8033,12 @@ var init_translate2 = __esm({
 });
 
 // src/launcher/modelPicker.ts
+function labelOf(model) {
+  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M) ? model.slice(0, -CONTEXT_MARKER_1M.length) : model;
+}
+function describedAs(model, description) {
+  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M) ? `${description}; 1M context` : description;
+}
 function joined(parts) {
   const last = parts[parts.length - 1];
   return last === void 0 || parts.length === 1 ? last ?? "" : `${parts.slice(0, -1).join(", ")} and ${last}`;
@@ -8026,7 +8052,7 @@ function rowOf2(model, reaches) {
   const fallbacks = reaches.filter((reach) => reach.standing === "fallback").map((reach) => reach.tier);
   const serves = firsts.length === 0 ? [] : [`Serves the ${joined(firsts)} tier${firsts.length === 1 ? "" : "s"}`];
   const falls = fallbacks.length === 0 ? [] : [`${serves.length === 0 ? "Fallback" : "fallback"} for ${joined(fallbacks)}`];
-  return { model, label: model, description: [...serves, ...falls].join("; "), behavesAs: TIER_BEHAVES_AS[lead.tier] };
+  return { model, label: labelOf(model), description: describedAs(model, [...serves, ...falls].join("; ")), behavesAs: TIER_BEHAVES_AS[lead.tier] };
 }
 function rowsOfTable(table) {
   const reachesByModel = /* @__PURE__ */ new Map();
@@ -8043,47 +8069,53 @@ function rowsOfTable(table) {
 }
 function antigravityRows(provider) {
   const config = resolveAntigravityConfig(provider.antigravity);
-  const tiers = rowsOfTable(ANTIGRAVITY_TIERS.map((tier) => [tier, config.models[tier]]));
+  const tiers = rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, config.models[tier]]));
   const behavesAsOf = new Map(tiers.map((row) => [row.model, row.behavesAs]));
   const aliases = [...config.aliases].flatMap(([alias, candidates]) => {
     const [first] = candidates;
     const behavesAs = first === void 0 ? void 0 : behavesAsOf.get(first);
-    return behavesAs === void 0 ? [] : [{ model: alias, label: alias, description: `Alias for ${candidates.join(", then ")}`, behavesAs }];
+    return behavesAs === void 0 ? [] : [{ model: alias, label: labelOf(alias), description: `Alias for ${candidates.join(", then ")}`, behavesAs }];
   });
   return [...tiers, ...aliases];
 }
 function codexRows(provider) {
   const config = resolveCodexConfig(provider.codex);
-  return rowsOfTable(CODEX_TIERS.map((tier) => [tier, [config.models[tier]]]));
+  return rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, [config.models[tier]]]));
 }
 function httpRows(provider) {
   const env = provider.env ?? {};
-  const table = CODEX_TIERS.flatMap((tier) => {
+  const table = CLAUDE_TIERS.flatMap((tier) => {
     const model = env[TIER_ENV_VARIABLES[tier]];
     return model === void 0 || model === "" ? [] : [[tier, [model]]];
   });
   return rowsOfTable(table);
 }
+function declaredRow(entry) {
+  return {
+    model: entry.model,
+    label: entry.label ?? labelOf(entry.model),
+    description: entry.description ?? describedAs(entry.model, `Declared by the provider for the ${entry.tier} tier`),
+    behavesAs: TIER_BEHAVES_AS[entry.tier]
+  };
+}
 function providerModelRows(provider) {
-  if (provider.kind === "codex") {
-    return codexRows(provider);
-  }
-  if (provider.kind === "antigravity") {
-    return antigravityRows(provider);
-  }
-  return httpRows(provider);
+  const derived = provider.kind === "codex" ? codexRows(provider) : provider.kind === "antigravity" ? antigravityRows(provider) : httpRows(provider);
+  const declared = (provider.pickerModels ?? []).map(declaredRow);
+  const declaredModels = new Set(declared.map((row) => row.model));
+  return [...derived.filter((row) => !declaredModels.has(row.model)), ...declared];
 }
 function modelPickerSettings(provider) {
   const options = providerModelRows(provider);
   return options.length === 0 ? void 0 : JSON.stringify({ modelPicker: { options, replaceBuiltInOptions: true } });
 }
-var TIER_BEHAVES_AS, TIER_ENV_VARIABLES;
+var CONTEXT_MARKER_1M, TIER_BEHAVES_AS, TIER_ENV_VARIABLES;
 var init_modelPicker = __esm({
   "src/launcher/modelPicker.ts"() {
     "use strict";
     init_translate();
     init_translate2();
     init_schema();
+    CONTEXT_MARKER_1M = "[1m]";
     TIER_BEHAVES_AS = Object.freeze({
       fable: "claude-fable-5-1",
       opus: "claude-opus-5-5",

package/dist/index.mjs

@@ -223,7 +223,7 @@ function isTimeZone(name) {
     return false;
   }
 }
-var CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, ANTIGRAVITY_TIERS, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_MODEL, ANTIGRAVITY_DEFAULT_TIER_MODELS, ANTIGRAVITY_DEFAULT_EFFORT, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_TIERS, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_LOGIN, CODEX_DEFAULT_MODEL, CODEX_DEFAULT_TIER_MODELS, CODEX_DEFAULT_EFFORT, CodexProviderConfigSchema, ProviderRouteSchema, HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema, ProviderSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, WHOLE_PERCENT_MAX, CompactAtUtilisationSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
+var CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, CLAUDE_TIERS, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_MODEL, ANTIGRAVITY_DEFAULT_TIER_MODELS, ANTIGRAVITY_DEFAULT_EFFORT, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_LOGIN, CODEX_DEFAULT_MODEL, CODEX_DEFAULT_TIER_MODELS, CODEX_DEFAULT_EFFORT, CodexProviderConfigSchema, ProviderRouteSchema, PickerModelSchema, PickerModelsSchema, HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema, ProviderSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, WHOLE_PERCENT_MAX, CompactAtUtilisationSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
 var init_schema = __esm({
   "src/config/schema.ts"() {
     "use strict";
@@ -321,7 +321,7 @@ var init_schema = __esm({
     });
     PROVIDER_KINDS = ["http", "codex", "antigravity"];
     ANTIGRAVITY_MODES = ["cloud", "local"];
-    ANTIGRAVITY_TIERS = ["fable", "opus", "sonnet", "haiku"];
+    CLAUDE_TIERS = ["fable", "opus", "sonnet", "haiku"];
     ANTIGRAVITY_EFFORTS = ["none", "low", "medium", "high", "xhigh", "max"];
     ANTIGRAVITY_DEFAULT_MODE = "cloud";
     ANTIGRAVITY_DEFAULT_MODEL = "gemini-3.8-flash-high";
@@ -338,7 +338,7 @@ var init_schema = __esm({
       mode: z.enum(ANTIGRAVITY_MODES).optional(),
       /** The model a request maps to when no tier matches its model name. */
       defaultModel: z.string().min(1).optional(),
-      /** Model name mapping. A key naming a tier (`fable`, `opus`, `sonnet`, `haiku`) overrides that tier's shipped model and is matched by substring of the requested name in `ANTIGRAVITY_TIERS` order; any other key is an alias, matched against the whole requested name case-insensitively, so `/model <alias>` selects its backend model. An alias outranks every other rule, including the pass-through of backend names. A value is one model or an ordered list of candidates: the request goes to the first whose quota windows are not spent, and when every candidate is spent, to the one whose binding window lifts soonest. */
+      /** Model name mapping. A key naming a tier (`fable`, `opus`, `sonnet`, `haiku`) overrides that tier's shipped model and is matched by substring of the requested name in `CLAUDE_TIERS` order; any other key is an alias, matched against the whole requested name case-insensitively, so `/model <alias>` selects its backend model. An alias outranks every other rule, including the pass-through of backend names. A value is one model or an ordered list of candidates: the request goes to the first whose quota windows are not spent, and when every candidate is spent, to the one whose binding window lifts soonest. */
       models: z.record(z.string().min(1), AntigravityModelTargetSchema).optional(),
       /** When every candidate of the tier a request names has no quota left, serve it from the next tier down, and onward through the lower tiers, instead of failing with the quota limit. Applies to a name that selects a tier (`/model fable`), not to an alias or a backend model name. Defaults to false. */
       degradeDownTiers: z.boolean().optional(),
@@ -361,7 +361,6 @@ var init_schema = __esm({
         socketPath: z.string().min(1).optional()
       }).optional()
     });
-    CODEX_TIERS = ["fable", "opus", "sonnet", "haiku"];
     CODEX_EFFORTS = ["none", "low", "medium", "high"];
     CODEX_LOGINS = ["codex-cli", "chatgpt-sign-in"];
     CODEX_DEFAULT_LOGIN = "codex-cli";
@@ -376,7 +375,7 @@ var init_schema = __esm({
     CodexProviderConfigSchema = z.strictObject({
       /** The codex model a request maps to when no tier matches its model name. */
       defaultModel: z.string().min(1).optional(),
-      /** Per-tier overrides of the shipped mapping, matched by substring of the requested model name in `CODEX_TIERS` order. */
+      /** Per-tier overrides of the shipped mapping, matched by substring of the requested model name in `CLAUDE_TIERS` order. */
       models: z.strictObject({
         fable: z.string().min(1).optional(),
         opus: z.string().min(1).optional(),
@@ -396,6 +395,13 @@ var init_schema = __esm({
       /** The model name to rewrite the request to before it reaches the target, for a provider that expects another form (OpenRouter's `anthropic/claude-...` for instance). A route that rewrites reads the whole body, the one copy the rewrite needs. */
       model: z.string().min(1).optional()
     });
+    PickerModelSchema = z.strictObject({
+      model: z.string().min(1),
+      tier: z.enum(CLAUDE_TIERS),
+      label: z.string().min(1).optional(),
+      description: z.string().min(1).optional()
+    });
+    PickerModelsSchema = z.array(PickerModelSchema).refine((models) => new Set(models.map((entry) => entry.model)).size === models.length, { message: "pickerModels names a model more than once" });
     HttpProviderSchema = z.strictObject({
       $schema: z.string().optional(),
       kind: z.literal("http").optional(),
@@ -403,6 +409,8 @@ var init_schema = __esm({
       baseUrl: z.url(),
       credential: ProviderCredentialSchema,
       env: ProviderEnvSchema.optional(),
+      /** Extra models `/model` lists beside the ones the tier settings name. */
+      pickerModels: PickerModelsSchema.optional(),
       /** Per-request routing: when present, each request this provider would serve is matched against the list in order, and the first definite match is sent to that entry's provider instead (itself resolved exactly as a directly dialled request would be). Unmatched requests stay on this provider. */
       routes: z.array(ProviderRouteSchema).optional()
     });
@@ -412,6 +420,8 @@ var init_schema = __esm({
       displayName: z.string().min(1),
       credential: ProviderCredentialSchema,
       env: ProviderEnvSchema.optional(),
+      /** Extra models `/model` lists beside the ones the tier settings name. */
+      pickerModels: PickerModelsSchema.optional(),
       codex: CodexProviderConfigSchema.optional()
     });
     AntigravityProviderSchema = z.strictObject({
@@ -420,6 +430,8 @@ var init_schema = __esm({
       displayName: z.string().min(1),
       credential: ProviderCredentialSchema,
       env: ProviderEnvSchema.optional(),
+      /** Extra models `/model` lists beside the ones the tier settings name. */
+      pickerModels: PickerModelsSchema.optional(),
       antigravity: AntigravityProviderConfigSchema.optional()
     });
     ProviderSchema = z.discriminatedUnion("kind", [HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema]);
@@ -2911,7 +2923,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.24.0",
+      version: "11.25.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -6537,7 +6549,8 @@ function addProvider(paths, name, input) {
   const shared = {
     displayName: input.displayName,
     credential: { sources: input.sources, ...input.target === void 0 ? {} : { target: input.target } },
-    ...input.env === void 0 || Object.keys(input.env).length === 0 ? {} : { env: input.env }
+    ...input.env === void 0 || Object.keys(input.env).length === 0 ? {} : { env: input.env },
+    ...input.pickerModels === void 0 || input.pickerModels.length === 0 ? {} : { pickerModels: input.pickerModels }
   };
   const parsed = ProviderSchema.safeParse(
     kind === "codex" ? { kind, ...shared, ...isEmptyCodexConfig(input.codex) ? {} : { codex: input.codex } } : kind === "antigravity" ? { kind, ...shared, ...isEmptyAntigravityConfig(input.antigravity) ? {} : { antigravity: input.antigravity } } : { ...shared, baseUrl: input.baseUrl }
@@ -6555,6 +6568,12 @@ function updateProvider(paths, name, input) {
   }
   const unset = new Set(input.unsetEnv);
   const env = Object.fromEntries(Object.entries({ ...existing.env, ...input.env }).filter(([key]) => !unset.has(key)));
+  const unsetPicker = new Set(input.unsetPickerModels);
+  const added = new Map((input.pickerModels ?? []).map((entry) => [entry.model, entry]));
+  const pickerModels = [
+    ...(existing.pickerModels ?? []).filter((entry) => !unsetPicker.has(entry.model)).map((entry) => added.get(entry.model) ?? entry),
+    ...[...added.values()].filter((entry) => !(existing.pickerModels ?? []).some((kept) => kept.model === entry.model))
+  ];
   const target = input.target ?? existing.credential.target;
   const cache = input.cache === void 0 ? existing.credential.cache : input.cache === false ? void 0 : input.cache;
   if (isCodexProvider(existing) && input.baseUrl !== void 0) {
@@ -6576,7 +6595,8 @@ function updateProvider(paths, name, input) {
       ...target === void 0 ? {} : { target },
       ...cache === void 0 ? {} : { cache }
     },
-    env: Object.keys(env).length === 0 ? void 0 : env
+    env: Object.keys(env).length === 0 ? void 0 : env,
+    pickerModels: pickerModels.length === 0 ? void 0 : pickerModels
   };
   let candidate;
   if (isCodexProvider(existing)) {
@@ -7919,7 +7939,7 @@ function candidatesOf(target) {
   return typeof target === "string" ? [target] : target;
 }
 function isAntigravityTier(key) {
-  return ANTIGRAVITY_TIERS.some((tier) => tier === key);
+  return CLAUDE_TIERS.some((tier) => tier === key);
 }
 function resolveAntigravityConfig(config) {
   const overrides = config?.models ?? {};
@@ -7985,6 +8005,12 @@ var init_translate2 = __esm({
 });
 
 // src/launcher/modelPicker.ts
+function labelOf(model) {
+  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M) ? model.slice(0, -CONTEXT_MARKER_1M.length) : model;
+}
+function describedAs(model, description) {
+  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M) ? `${description}; 1M context` : description;
+}
 function joined(parts) {
   const last = parts[parts.length - 1];
   return last === void 0 || parts.length === 1 ? last ?? "" : `${parts.slice(0, -1).join(", ")} and ${last}`;
@@ -7998,7 +8024,7 @@ function rowOf2(model, reaches) {
   const fallbacks = reaches.filter((reach) => reach.standing === "fallback").map((reach) => reach.tier);
   const serves = firsts.length === 0 ? [] : [`Serves the ${joined(firsts)} tier${firsts.length === 1 ? "" : "s"}`];
   const falls = fallbacks.length === 0 ? [] : [`${serves.length === 0 ? "Fallback" : "fallback"} for ${joined(fallbacks)}`];
-  return { model, label: model, description: [...serves, ...falls].join("; "), behavesAs: TIER_BEHAVES_AS[lead.tier] };
+  return { model, label: labelOf(model), description: describedAs(model, [...serves, ...falls].join("; ")), behavesAs: TIER_BEHAVES_AS[lead.tier] };
 }
 function rowsOfTable(table) {
   const reachesByModel = /* @__PURE__ */ new Map();
@@ -8015,47 +8041,53 @@ function rowsOfTable(table) {
 }
 function antigravityRows(provider) {
   const config = resolveAntigravityConfig(provider.antigravity);
-  const tiers = rowsOfTable(ANTIGRAVITY_TIERS.map((tier) => [tier, config.models[tier]]));
+  const tiers = rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, config.models[tier]]));
   const behavesAsOf = new Map(tiers.map((row) => [row.model, row.behavesAs]));
   const aliases = [...config.aliases].flatMap(([alias, candidates]) => {
     const [first] = candidates;
     const behavesAs = first === void 0 ? void 0 : behavesAsOf.get(first);
-    return behavesAs === void 0 ? [] : [{ model: alias, label: alias, description: `Alias for ${candidates.join(", then ")}`, behavesAs }];
+    return behavesAs === void 0 ? [] : [{ model: alias, label: labelOf(alias), description: `Alias for ${candidates.join(", then ")}`, behavesAs }];
   });
   return [...tiers, ...aliases];
 }
 function codexRows(provider) {
   const config = resolveCodexConfig(provider.codex);
-  return rowsOfTable(CODEX_TIERS.map((tier) => [tier, [config.models[tier]]]));
+  return rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, [config.models[tier]]]));
 }
 function httpRows(provider) {
   const env = provider.env ?? {};
-  const table = CODEX_TIERS.flatMap((tier) => {
+  const table = CLAUDE_TIERS.flatMap((tier) => {
     const model = env[TIER_ENV_VARIABLES[tier]];
     return model === void 0 || model === "" ? [] : [[tier, [model]]];
   });
   return rowsOfTable(table);
 }
+function declaredRow(entry) {
+  return {
+    model: entry.model,
+    label: entry.label ?? labelOf(entry.model),
+    description: entry.description ?? describedAs(entry.model, `Declared by the provider for the ${entry.tier} tier`),
+    behavesAs: TIER_BEHAVES_AS[entry.tier]
+  };
+}
 function providerModelRows(provider) {
-  if (provider.kind === "codex") {
-    return codexRows(provider);
-  }
-  if (provider.kind === "antigravity") {
-    return antigravityRows(provider);
-  }
-  return httpRows(provider);
+  const derived = provider.kind === "codex" ? codexRows(provider) : provider.kind === "antigravity" ? antigravityRows(provider) : httpRows(provider);
+  const declared = (provider.pickerModels ?? []).map(declaredRow);
+  const declaredModels = new Set(declared.map((row) => row.model));
+  return [...derived.filter((row) => !declaredModels.has(row.model)), ...declared];
 }
 function modelPickerSettings(provider) {
   const options = providerModelRows(provider);
   return options.length === 0 ? void 0 : JSON.stringify({ modelPicker: { options, replaceBuiltInOptions: true } });
 }
-var TIER_BEHAVES_AS, TIER_ENV_VARIABLES;
+var CONTEXT_MARKER_1M, TIER_BEHAVES_AS, TIER_ENV_VARIABLES;
 var init_modelPicker = __esm({
   "src/launcher/modelPicker.ts"() {
     "use strict";
     init_translate();
     init_translate2();
     init_schema();
+    CONTEXT_MARKER_1M = "[1m]";
     TIER_BEHAVES_AS = Object.freeze({
       fable: "claude-fable-5-1",
       opus: "claude-opus-5-5",

package/dist/types/index.d.ts

@@ -434,6 +434,21 @@ declare const CodexProviderConfigSchema: z.ZodObject<{
     }>>;
 }, z.core.$strict>;
 type CodexProviderConfig = z.infer<typeof CodexProviderConfigSchema>;
+/**
+ * A model a provider serves that `/model` should list beside the ones its tier settings name. `tier` is the Claude tier whose client-side handling (prompt profile, effort defaults) the row borrows, since Claude Code knows no handling for a model it has not heard of. `label` defaults to the model name and `description` to a generic line.
+ */
+declare const PickerModelSchema: z.ZodObject<{
+    model: z.ZodString;
+    tier: z.ZodEnum<{
+        fable: "fable";
+        opus: "opus";
+        sonnet: "sonnet";
+        haiku: "haiku";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type PickerModel = z.infer<typeof PickerModelSchema>;
 /** All kinds of provider; see `HttpProviderSchema` for the shared fields. */
 declare const ProviderSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
@@ -476,6 +491,17 @@ declare const ProviderSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }>>;
     }, z.core.$strict>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    pickerModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        tier: z.ZodEnum<{
+            fable: "fable";
+            opus: "opus";
+            sonnet: "sonnet";
+            haiku: "haiku";
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
     routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
         when: z.ZodUnion<readonly [z.ZodObject<{
             newerThan: z.ZodOptional<z.ZodString>;
@@ -592,6 +618,17 @@ declare const ProviderSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }>>;
     }, z.core.$strict>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    pickerModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        tier: z.ZodEnum<{
+            fable: "fable";
+            opus: "opus";
+            sonnet: "sonnet";
+            haiku: "haiku";
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
     codex: z.ZodOptional<z.ZodObject<{
         defaultModel: z.ZodOptional<z.ZodString>;
         models: z.ZodOptional<z.ZodObject<{
@@ -651,6 +688,17 @@ declare const ProviderSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }>>;
     }, z.core.$strict>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    pickerModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        tier: z.ZodEnum<{
+            fable: "fable";
+            opus: "opus";
+            sonnet: "sonnet";
+            haiku: "haiku";
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
     antigravity: z.ZodOptional<z.ZodObject<{
         mode: z.ZodOptional<z.ZodEnum<{
             cloud: "cloud";
@@ -4323,10 +4371,10 @@ declare const CheckReportJsonSchema: z.ZodObject<{
     configProfile: z.ZodObject<{
         name: z.ZodNullable<z.ZodString>;
         source: z.ZodEnum<{
-            "directory-rule": "directory-rule";
             env: "env";
             none: "none";
             "cli-flag": "cli-flag";
+            "directory-rule": "directory-rule";
             "identity-default": "identity-default";
             "global-default": "global-default";
         }>;
@@ -4334,9 +4382,9 @@ declare const CheckReportJsonSchema: z.ZodObject<{
     layers: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         id: z.ZodInt;
         kind: z.ZodEnum<{
+            "directory-rule": "directory-rule";
             "global-config": "global-config";
             "config-profile": "config-profile";
-            "directory-rule": "directory-rule";
             portable: "portable";
             "portable-local": "portable-local";
             "cli-override": "cli-override";
@@ -7378,10 +7426,10 @@ declare function createLaunchApiRouter(deps: LaunchApiDeps): {
                 configDir: zod.ZodOptional<zod.ZodString>;
                 configProfile: zod.ZodOptional<zod.ZodString>;
                 configProfileSource: zod.ZodEnum<{
-                    "directory-rule": "directory-rule";
                     env: "env";
                     none: "none";
                     "cli-flag": "cli-flag";
+                    "directory-rule": "directory-rule";
                     "identity-default": "identity-default";
                     "global-default": "global-default";
                 }>;
@@ -8015,10 +8063,10 @@ declare function createControlApiRouter(deps: ControlApiDeps): {
             configProfile: zod.ZodObject<{
                 name: zod.ZodNullable<zod.ZodString>;
                 source: zod.ZodEnum<{
-                    "directory-rule": "directory-rule";
                     env: "env";
                     none: "none";
                     "cli-flag": "cli-flag";
+                    "directory-rule": "directory-rule";
                     "identity-default": "identity-default";
                     "global-default": "global-default";
                 }>;
@@ -8026,9 +8074,9 @@ declare function createControlApiRouter(deps: ControlApiDeps): {
             layers: zod.ZodReadonly<zod.ZodArray<zod.ZodObject<{
                 id: zod.ZodInt;
                 kind: zod.ZodEnum<{
+                    "directory-rule": "directory-rule";
                     "global-config": "global-config";
                     "config-profile": "config-profile";
-                    "directory-rule": "directory-rule";
                     portable: "portable";
                     "portable-local": "portable-local";
                     "cli-override": "cli-override";
@@ -8266,12 +8314,12 @@ declare function createControlApiRouter(deps: ControlApiDeps): {
             ok: zod.ZodBoolean;
             findings: zod.ZodReadonly<zod.ZodArray<zod.ZodObject<{
                 section: zod.ZodEnum<{
-                    "global-config": "global-config";
-                    "config-profile": "config-profile";
                     identity: "identity";
                     provider: "provider";
                     frontdoor: "frontdoor";
                     pool: "pool";
+                    "global-config": "global-config";
+                    "config-profile": "config-profile";
                     keychain: "keychain";
                     "ambient-credential": "ambient-credential";
                     "binary-discovery": "binary-discovery";
@@ -8494,10 +8542,10 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                 configDir: zod.ZodOptional<zod.ZodString>;
                 configProfile: zod.ZodOptional<zod.ZodString>;
                 configProfileSource: zod.ZodEnum<{
-                    "directory-rule": "directory-rule";
                     env: "env";
                     none: "none";
                     "cli-flag": "cli-flag";
+                    "directory-rule": "directory-rule";
                     "identity-default": "identity-default";
                     "global-default": "global-default";
                 }>;
@@ -10128,10 +10176,10 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
             configProfile: zod.ZodObject<{
                 name: zod.ZodNullable<zod.ZodString>;
                 source: zod.ZodEnum<{
-                    "directory-rule": "directory-rule";
                     env: "env";
                     none: "none";
                     "cli-flag": "cli-flag";
+                    "directory-rule": "directory-rule";
                     "identity-default": "identity-default";
                     "global-default": "global-default";
                 }>;
@@ -10139,9 +10187,9 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
             layers: zod.ZodReadonly<zod.ZodArray<zod.ZodObject<{
                 id: zod.ZodInt;
                 kind: zod.ZodEnum<{
+                    "directory-rule": "directory-rule";
                     "global-config": "global-config";
                     "config-profile": "config-profile";
-                    "directory-rule": "directory-rule";
                     portable: "portable";
                     "portable-local": "portable-local";
                     "cli-override": "cli-override";
@@ -10379,12 +10427,12 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
             ok: zod.ZodBoolean;
             findings: zod.ZodReadonly<zod.ZodArray<zod.ZodObject<{
                 section: zod.ZodEnum<{
-                    "global-config": "global-config";
-                    "config-profile": "config-profile";
                     identity: "identity";
                     provider: "provider";
                     frontdoor: "frontdoor";
                     pool: "pool";
+                    "global-config": "global-config";
+                    "config-profile": "config-profile";
                     keychain: "keychain";
                     "ambient-credential": "ambient-credential";
                     "binary-discovery": "binary-discovery";
@@ -12244,12 +12292,12 @@ declare const CheckRunInputSchema: z.ZodObject<{
 /** One line of the doctor report: the section it belongs to, its severity, its message, and the identity/profile/rule it is about when there is one. */
 declare const DoctorFindingSchema: z.ZodObject<{
     section: z.ZodEnum<{
-        "global-config": "global-config";
-        "config-profile": "config-profile";
         identity: "identity";
         provider: "provider";
         frontdoor: "frontdoor";
         pool: "pool";
+        "global-config": "global-config";
+        "config-profile": "config-profile";
         keychain: "keychain";
         "ambient-credential": "ambient-credential";
         "binary-discovery": "binary-discovery";
@@ -12275,12 +12323,12 @@ declare const DoctorRunOutputSchema: z.ZodObject<{
     ok: z.ZodBoolean;
     findings: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         section: z.ZodEnum<{
-            "global-config": "global-config";
-            "config-profile": "config-profile";
             identity: "identity";
             provider: "provider";
             frontdoor: "frontdoor";
             pool: "pool";
+            "global-config": "global-config";
+            "config-profile": "config-profile";
             keychain: "keychain";
             "ambient-credential": "ambient-credential";
             "binary-discovery": "binary-discovery";
@@ -12383,10 +12431,10 @@ declare const LaunchResolveOutputSchema: z.ZodObject<{
         configDir: z.ZodOptional<z.ZodString>;
         configProfile: z.ZodOptional<z.ZodString>;
         configProfileSource: z.ZodEnum<{
-            "directory-rule": "directory-rule";
             env: "env";
             none: "none";
             "cli-flag": "cli-flag";
+            "directory-rule": "directory-rule";
             "identity-default": "identity-default";
             "global-default": "global-default";
         }>;
@@ -13416,6 +13464,8 @@ interface AddProviderInput {
     readonly sources: readonly CredentialSource[];
     readonly target?: ProviderCredentialTarget;
     readonly env?: Readonly<Record<string, string>>;
+    /** Extra models `/model` lists beside the ones the tier settings name; applies to every provider kind. */
+    readonly pickerModels?: readonly PickerModel[];
     readonly codex?: CodexProviderConfig;
     readonly antigravity?: AntigravityProviderConfig;
 }
@@ -13439,6 +13489,10 @@ interface UpdateProviderInput {
     readonly cache?: CredentialCache | false;
     readonly env?: Readonly<Record<string, string>>;
     readonly unsetEnv?: readonly string[];
+    /** Picker models to add; one for a model the provider already declares replaces that entry in place. */
+    readonly pickerModels?: readonly PickerModel[];
+    /** Models whose picker entries are removed. */
+    readonly unsetPickerModels?: readonly string[];
     /** Merged over a codex provider's existing settings: a field given here replaces that field, and `models` entries merge per tier. */
     readonly codex?: CodexProviderConfig;
     /** Merged over an antigravity provider's existing settings: a field given here replaces that field, and `models` entries merge per tier. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-use",
-  "version": "11.24.0",
+  "version": "11.25.0",
   "description": "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
   "license": "MIT",
   "author": "Joseph Mearman <joseph@mearman.co.uk>",