claude-use 11.29.0 → 11.31.0

package/README.md

@@ -98,7 +98,7 @@ agent-shim profile set <name> [--category <category>=<bool>]... [--entry <catego
 agent-shim profile set <name> [--extends <profile>]... [--no-extends] [--description <text> | --no-description] [--json]
 agent-shim profile set <name> [--[no-]launch-skip-permissions] [--[no-]launch-remote-control] [--[no-]launch-headroom] [--[no-]launch-track-usage]
 agent-shim profile set <name> [--launch-claude-version <version> | --no-launch-claude-version] [--json] [--json]
-agent-shim profile set <name> [--launch-delay <duration> | --no-launch-delay] [--[no-]launch-pause] [--json]
+agent-shim profile set <name> [--launch-delay <duration> | --no-launch-delay] [--[no-]launch-pause] [--[no-]launch-explain] [--json]
 agent-shim profile set <name> [--launch-provider <provider> | --no-launch-provider] [--json]
 agent-shim profile list [--json]
 agent-shim profile show <name> [--json]
@@ -183,6 +183,7 @@ agent-shim run [@<identity>] [launch flags] [claude arguments]
   #   --[no-]skip-permissions  --[no-]remote-control  --[no-]headroom  --[no-]track-usage  --[no-]wait
   #   --claude-version <version>   run exactly this installed Claude Code version
   #   --delay <duration>   wait this long after the launcher's own output before starting claude; --[no-]pause waits for a key press instead
+  #   --[no-]explain   with @pool:<name>, list every member the pick ranked and why, not only the one picked
   #   --native   run the real claude with nothing from agent-shim applied; cannot be combined with the flags above
 claude @<identity> ...                      # the same, once `agent-shim shim enable` has run
 ```

package/dist/cli.cjs

@@ -27031,7 +27031,9 @@ var init_schema = __esm({
       /** How long the launcher waits after its own output before it starts claude, so that output can be read before Claude Code takes over the terminal (`5s`, `500ms`). Applies only when a terminal is watching. */
       delay: external_exports.string().regex(DURATION_RE, "must be a duration such as 5s or 500ms").optional(),
       /** Whether the launcher waits for a key press after its own output before it starts claude. Takes the place of `delay` when both are set. Applies only when a terminal is watching. */
-      pause: external_exports.boolean().optional()
+      pause: external_exports.boolean().optional(),
+      /** Whether the launcher's report, for a launch that picks from a pool, lists every member the pick ranked with why each stands where it does, and not only the member it picked. */
+      explain: external_exports.boolean().optional()
     });
     CREDENTIAL_TARGETS = ["bearer", "apiKey", "oauthToken"];
     PROVIDER_CREDENTIAL_TARGETS = ["bearer", "apiKey"];
@@ -32571,6 +32573,9 @@ function flattenLayers(layers, options) {
       if (layer.launch.pause !== void 0) {
         launch.pause = layer.launch.pause;
       }
+      if (layer.launch.explain !== void 0) {
+        launch.explain = layer.launch.explain;
+      }
     }
     if (layer.entries === void 0) {
       continue;
@@ -34318,7 +34323,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.29.0",
+      version: "11.31.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>",
@@ -63125,7 +63130,8 @@ var init_argv = __esm({
       { flag: "--skip-permissions", key: "skipPermissions" },
       { flag: "--remote-control", key: "remoteControl" },
       { flag: "--wait", key: "wait" },
-      { flag: "--pause", key: "pause" }
+      { flag: "--pause", key: "pause" },
+      { flag: "--explain", key: "explain" }
     ];
     LAUNCHER_FLAG_NAMES = [
       ...VALUED_FLAGS,
@@ -63314,6 +63320,7 @@ function resolveLaunchFlags(params) {
     headroom: params.flags?.headroom ?? parseEnvBool("AGENT_SHIM_HEADROOM", params.env.AGENT_SHIM_HEADROOM) ?? params.cascade?.headroom ?? false,
     trackUsage: params.flags?.trackUsage ?? parseEnvBool("AGENT_SHIM_TRACK_USAGE", params.env.AGENT_SHIM_TRACK_USAGE) ?? params.cascade?.trackUsage ?? true,
     pause: params.flags?.pause ?? parseEnvBool("AGENT_SHIM_PAUSE", params.env.AGENT_SHIM_PAUSE) ?? params.cascade?.pause ?? false,
+    explain: params.flags?.explain ?? parseEnvBool("AGENT_SHIM_EXPLAIN", params.env.AGENT_SHIM_EXPLAIN) ?? params.cascade?.explain ?? false,
     delayMs: resolveDelayMs(params)
   };
 }
@@ -63687,6 +63694,18 @@ var init_hold = __esm({
   }
 });
 
+// src/usage/candidateText.ts
+function candidateHeading(candidate) {
+  const score = candidate.score === void 0 ? "" : ` score ${candidate.score.toFixed(2)}${candidate.scoreWindow === "fiveHour" ? " by 5h reset" : " by 7d reset"}`;
+  const dry = candidate.feasible ? "" : " (5h would run dry)";
+  return `[${candidate.class}${score}]${dry}`;
+}
+var init_candidateText = __esm({
+  "src/usage/candidateText.ts"() {
+    "use strict";
+  }
+});
+
 // src/launcher/launchReport.ts
 function poolDetail(pool) {
   const [reason] = pool.reasons;
@@ -63695,6 +63714,12 @@ function poolDetail(pool) {
   }
   return reason === void 0 ? {} : { detail: reason };
 }
+function rankingNotes(ranking, picked) {
+  return ranking.flatMap((candidate, index) => [
+    `${String(index + 1)}. ${candidate.identity} ${candidateHeading(candidate)}${candidate.identity === picked ? " (picked)" : ""}`,
+    `   ${candidate.reasons.join("; ")}`
+  ]);
+}
 function decisionRows(facts) {
   return [
     { label: "identity", value: facts.identity ?? "(none)", detail: facts.identitySource },
@@ -63702,7 +63727,8 @@ function decisionRows(facts) {
       {
         label: "pool",
         value: facts.pool.name,
-        ...poolDetail(facts.pool)
+        ...poolDetail(facts.pool),
+        ...facts.ranking === void 0 ? {} : { notes: rankingNotes(facts.ranking, facts.identity) }
       }
     ],
     ...facts.profile === void 0 ? [] : [{ label: "profile", value: facts.profile.name, detail: facts.profile.source }],
@@ -63737,6 +63763,7 @@ function noteRow(text2) {
 var init_launchReport = __esm({
   "src/launcher/launchReport.ts"() {
     "use strict";
+    init_candidateText();
   }
 });
 
@@ -64230,6 +64257,9 @@ function resolveAntigravityConfig(config2) {
     const target = overrides[tier];
     return target === void 0 ? ANTIGRAVITY_DEFAULT_TIER_MODELS[tier] : candidatesOf(target);
   };
+  if (!aliases.has(AUTO_ALIAS)) {
+    aliases.set(AUTO_ALIAS, [...new Set(CLAUDE_TIERS.flatMap(tierModel))]);
+  }
   return {
     mode: config2?.mode ?? ANTIGRAVITY_DEFAULT_MODE,
     defaultModel: config2?.defaultModel ?? ANTIGRAVITY_DEFAULT_MODEL,
@@ -64496,7 +64526,7 @@ function translateRequest(request7, config2, routing) {
     toolNames
   };
 }
-var import_node_crypto16, CONTEXT_MARKER_1M, BACKEND_FAMILY_PREFIXES, BACKEND_CLAUDE_NAME, EFFORT_TO_BUDGET, BILLING_HEADER_LINE, ANTIGRAVITY_TOOL_NAME_LIMIT, TOOL_NAME_HASH_CHARS, NON_TEXT_TOOL_RESULT, EMPTY_SCHEMA, EFFORT_SUFFIXES;
+var import_node_crypto16, AUTO_ALIAS, CONTEXT_MARKER_1M, BACKEND_FAMILY_PREFIXES, BACKEND_CLAUDE_NAME, EFFORT_TO_BUDGET, BILLING_HEADER_LINE, ANTIGRAVITY_TOOL_NAME_LIMIT, TOOL_NAME_HASH_CHARS, NON_TEXT_TOOL_RESULT, EMPTY_SCHEMA, EFFORT_SUFFIXES;
 var init_translate = __esm({
   "src/antigravity/translate.ts"() {
     "use strict";
@@ -64505,6 +64535,7 @@ var init_translate = __esm({
     init_signatures();
     init_schema();
     init_anthropic();
+    AUTO_ALIAS = "auto";
     CONTEXT_MARKER_1M = "[1m]";
     BACKEND_FAMILY_PREFIXES = ["gemini-", "antigravity-", "gpt-oss-"];
     BACKEND_CLAUDE_NAME = /^claude-.+-(?:low|medium|high|thinking)$/;
@@ -64854,9 +64885,10 @@ function antigravityRows(provider) {
   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: labelOf(alias), description: `Alias for ${candidates.join(", then ")}`, behavesAs }];
+    const description = alias === AUTO_ALIAS ? `Routes each request to a backend model with quota left, best first (${String(candidates.length)} models)` : `Alias for ${candidates.join(", then ")}`;
+    return behavesAs === void 0 ? [] : [{ model: alias, label: labelOf(alias), description, behavesAs }];
   });
-  return [...tiers, ...aliases];
+  return [...aliases.filter((row) => row.model === AUTO_ALIAS), ...tiers, ...aliases.filter((row) => row.model !== AUTO_ALIAS)];
 }
 function codexRows(provider) {
   const config2 = resolveCodexConfig(provider.codex);
@@ -64991,6 +65023,7 @@ function resolvePoolLaunch(params) {
         identity: pick2.identity,
         explanation: `pool ${poolName}: ${move}${pick2.reasons.slice(0, REASONS_LOGGED).join("; ")}`,
         reasons: pick2.reasons,
+        candidates: graph.ranking.candidates,
         ...movedOff === void 0 ? {} : { movedOff }
       };
     }
@@ -65165,7 +65198,8 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   }
   return {
     identityDecision: { ...decided, name: resolution.identity },
-    poolPick: { name: decided.pool, reasons: resolution.reasons, ...resolution.movedOff === void 0 ? {} : { movedOff: resolution.movedOff } }
+    poolPick: { name: decided.pool, reasons: resolution.reasons, ...resolution.movedOff === void 0 ? {} : { movedOff: resolution.movedOff } },
+    poolRanking: resolution.candidates
   };
 }
 function decideLaunch(params, readOnly) {
@@ -65192,7 +65226,7 @@ function decideLaunch(params, readOnly) {
       return trimmed === "" ? void 0 : trimmed;
     }
   });
-  const { identityDecision, poolPick } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
+  const { identityDecision, poolPick, poolRanking } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
   const farmIdentity = configDirEscapeHatchApplies ? void 0 : identityDecision.name;
   const farm = farmIdentity === void 0 ? void 0 : params.farm;
   if (!readOnly && farm !== void 0 && farmIdentity !== void 0) {
@@ -65328,6 +65362,7 @@ function decideLaunch(params, readOnly) {
       ...parsedArgv.headroom === void 0 ? {} : { headroom: parsedArgv.headroom },
       ...parsedArgv.trackUsage === void 0 ? {} : { trackUsage: parsedArgv.trackUsage },
       ...parsedArgv.pause === void 0 ? {} : { pause: parsedArgv.pause },
+      ...parsedArgv.explain === void 0 ? {} : { explain: parsedArgv.explain },
       ...parsedArgv.delay === void 0 ? {} : { delay: parsedArgv.delay }
     }
   });
@@ -65364,6 +65399,7 @@ function decideLaunch(params, readOnly) {
     parsedArgv,
     identityDecision,
     poolPick,
+    poolRanking,
     notes,
     configDirEscapeHatch: configDirEscapeHatchApplies,
     farmIdentity,
@@ -65384,12 +65420,13 @@ function prepareLaunch(params) {
   const { paths, proc, log } = params;
   const { env } = proc;
   const decided = decideLaunch(params, false);
-  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolPick, notes, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
+  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolPick, poolRanking, notes, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
   const rows = [
     ...decisionRows({
       identity: identityDecision.name,
       identitySource: identityDecision.source,
       pool: poolPick,
+      ranking: resolvedFlags.explain ? poolRanking : void 0,
       profile: configProfileDecision.name === void 0 ? void 0 : { name: configProfileDecision.name, source: configProfileDecision.source },
       provider: resolvedProvider === void 0 ? void 0 : { name: resolvedProvider.name, credential: `${resolvedProvider.credential.target} from ${describeSource(resolvedProvider.credential.source)}` },
       identityCredential: identityCredential === void 0 ? void 0 : `${identityCredential.target} from ${describeSource(identityCredential.source)}`
@@ -111520,6 +111557,9 @@ function applyProfileChange(paths, name, change) {
   if (change.launchPause !== void 0) {
     launchPatch.pause = change.launchPause;
   }
+  if (change.launchExplain !== void 0) {
+    launchPatch.explain = change.launchExplain;
+  }
   if (Object.keys(launchPatch).length > 0) {
     setProfileLaunchFlags(paths, name, launchPatch);
     touched = true;
@@ -112806,7 +112846,7 @@ function registerProfileCommand(program2, deps) {
   withExamples(
     profile.command("set <name>").description(
       "Update a configuration profile's categories, entries, extends list, description or launch settings. With no options on a terminal, walks through its categories."
-    ).option("--category <category=bool>", "Share (true) or hide (false) a whole category (repeatable).", collectBoolPair).option("--entry <path=bool>", "Share (true) or hide (false) one <category>/<path> entry (repeatable).", collectBoolPair).option("--extends <profile>", "Replace the extends list with these profiles (repeatable, in order).", collectRepeated).option("--no-extends", "Clear the extends list.").option("--description <text>", "Replace the description.").option("--no-description", "Clear the description.").option("--launch-skip-permissions", "Launches under this profile skip permission prompts.").option("--no-launch-skip-permissions", "Launches under this profile keep permission prompts.").option("--launch-remote-control", "Launches under this profile enable Remote Control.").option("--no-launch-remote-control", "Launches under this profile leave Remote Control off.").option("--launch-headroom", "Launches under this profile route through headroom.").option("--no-launch-headroom", "Launches under this profile route direct.").option("--launch-track-usage", "Launches under this profile route through the front door so their requests and quota are recorded, with no headroom needed.").option("--no-launch-track-usage", "Launches under this profile are not recorded unless a provider or headroom routes them anyway.").option("--launch-provider <provider>", "Launches under this profile route through this provider.").option("--no-launch-provider", "Clear this profile's provider selection.").option("--launch-claude-version <version>", "Launches under this profile run exactly this installed Claude Code version (such as 2.1.220); a version that is not installed fails the launch.").option("--no-launch-claude-version", "Clear this profile's Claude Code version pin.").option("--launch-delay <duration>", "Launches under this profile wait this long (such as 5s) after the launcher's own output before starting claude, so the output can be read.", parseDurationLiteral).option("--no-launch-delay", "Clear this profile's launch delay.").option("--launch-pause", "Launches under this profile wait for a key press after the launcher's own output before starting claude.").option("--no-launch-pause", "Launches under this profile start claude without waiting for a key press.").option("--json", "Print the result as JSON.").action(async (name, allOptions) => {
+    ).option("--category <category=bool>", "Share (true) or hide (false) a whole category (repeatable).", collectBoolPair).option("--entry <path=bool>", "Share (true) or hide (false) one <category>/<path> entry (repeatable).", collectBoolPair).option("--extends <profile>", "Replace the extends list with these profiles (repeatable, in order).", collectRepeated).option("--no-extends", "Clear the extends list.").option("--description <text>", "Replace the description.").option("--no-description", "Clear the description.").option("--launch-skip-permissions", "Launches under this profile skip permission prompts.").option("--no-launch-skip-permissions", "Launches under this profile keep permission prompts.").option("--launch-remote-control", "Launches under this profile enable Remote Control.").option("--no-launch-remote-control", "Launches under this profile leave Remote Control off.").option("--launch-headroom", "Launches under this profile route through headroom.").option("--no-launch-headroom", "Launches under this profile route direct.").option("--launch-track-usage", "Launches under this profile route through the front door so their requests and quota are recorded, with no headroom needed.").option("--no-launch-track-usage", "Launches under this profile are not recorded unless a provider or headroom routes them anyway.").option("--launch-provider <provider>", "Launches under this profile route through this provider.").option("--no-launch-provider", "Clear this profile's provider selection.").option("--launch-claude-version <version>", "Launches under this profile run exactly this installed Claude Code version (such as 2.1.220); a version that is not installed fails the launch.").option("--no-launch-claude-version", "Clear this profile's Claude Code version pin.").option("--launch-delay <duration>", "Launches under this profile wait this long (such as 5s) after the launcher's own output before starting claude, so the output can be read.", parseDurationLiteral).option("--no-launch-delay", "Clear this profile's launch delay.").option("--launch-pause", "Launches under this profile wait for a key press after the launcher's own output before starting claude.").option("--no-launch-pause", "Launches under this profile start claude without waiting for a key press.").option("--launch-explain", "Launches under this profile that pick from a pool list every member the pick ranked and why, in the launcher's report.").option("--no-launch-explain", "Launches under this profile name only the member a pool pick chose.").option("--json", "Print the result as JSON.").action(async (name, allOptions) => {
       const { json: json2, ...options } = allOptions;
       requireProfileExists(paths, name);
       if (Object.entries(allOptions).every(([key, value2]) => key === "json" || value2 === void 0)) {
@@ -127708,7 +127748,8 @@ var ConfigProfileSetInputSchema = external_exports.strictObject({
     provider: external_exports.union([external_exports.string().min(1), external_exports.literal(false)]).optional(),
     claudeVersion: external_exports.union([external_exports.string().min(1), external_exports.literal(false)]).optional(),
     delay: external_exports.union([external_exports.string().regex(DURATION_RE), external_exports.literal(false)]).optional(),
-    pause: external_exports.boolean().optional()
+    pause: external_exports.boolean().optional(),
+    explain: external_exports.boolean().optional()
   }).optional()
 });
 var ConfigProfileSetOutputSchema = storedMutationOutput("profile", "updated", ProfileValueSchema);
@@ -127920,7 +127961,8 @@ function createConfigApiRouter(deps) {
               ...launch?.provider === void 0 ? {} : { launchProvider: launch.provider },
               ...launch?.claudeVersion === void 0 ? {} : { launchClaudeVersion: launch.claudeVersion },
               ...launch?.delay === void 0 ? {} : { launchDelay: launch.delay },
-              ...launch?.pause === void 0 ? {} : { launchPause: launch.pause }
+              ...launch?.pause === void 0 ? {} : { launchPause: launch.pause },
+              ...launch?.explain === void 0 ? {} : { launchExplain: launch.explain }
             });
             return { action: "updated", kind: "profile", name: input2.name, value: profileValue(input2.name, paths) };
           })
@@ -128221,6 +128263,7 @@ var LaunchFlagsSchema = external_exports.strictObject({
   headroom: external_exports.boolean(),
   trackUsage: external_exports.boolean(),
   pause: external_exports.boolean(),
+  explain: external_exports.boolean(),
   /** How long the launch waits after its own output before it starts claude, in milliseconds. */
   delayMs: external_exports.number()
 });
@@ -146123,13 +146166,12 @@ init_cliError();
 init_schema();
 init_schema();
 init_realPorts();
+init_candidateText();
 init_preflight();
 function formatPoolPick(report, nowMs) {
   const head = report.pick === void 0 ? `Pool ${report.pool}: every member is refused right now${report.earliestReturn === void 0 ? "" : `; ${report.earliestReturn.identity} returns at ${report.earliestReturn.at} (in ${formatAge(Date.parse(report.earliestReturn.at) - nowMs)})`}` : `Pool ${report.pool}: a launch from ${report.directory} would run as ${report.pick}`;
   const rows = report.candidates.map((candidate, index) => {
-    const score = candidate.score === void 0 ? "" : ` score ${candidate.score.toFixed(2)}${candidate.scoreWindow === "fiveHour" ? " by 5h reset" : " by 7d reset"}`;
-    const dry = candidate.feasible ? "" : " (5h would run dry)";
-    return `  ${String(index + 1)}. ${candidate.identity} [${candidate.class}${score}]${dry}
+    return `  ${String(index + 1)}. ${candidate.identity} ${candidateHeading(candidate)}
      ${candidate.reasons.join("; ")}`;
   });
   return [head, ...rows, ...report.missing.map((name) => `  (skipped: ${name} is not an identity)`), ...report.stickyProblem === void 0 ? [] : [`Note: ${report.stickyProblem}; the last-pick record was ignored.`]];
@@ -147029,11 +147071,12 @@ Launching:
     --[no-]wait                  with @pool:<name>, sleep until the earliest member returns when all are refused
     --delay <duration>           wait this long (5s, 500ms) after the launcher's own output before starting claude
     --[no-]pause                 wait for a key press after the launcher's own output before starting claude
+    --[no-]explain               with @pool:<name>, list every member the pick ranked and why, not only the one picked
     --native                     run the real claude with nothing from agent-shim applied (no other launch flag allowed)
 
 Environment:
   AGENT_SHIM_IDENTITY, AGENT_SHIM_CONFIG_PROFILE, AGENT_SHIM_SKIP_PERMISSIONS,
-  AGENT_SHIM_REMOTE_CONTROL, AGENT_SHIM_HEADROOM, AGENT_SHIM_TRACK_USAGE, AGENT_SHIM_DELAY, AGENT_SHIM_PAUSE, AGENT_SHIM_ALLOW_AMBIENT_CREDENTIAL,
+  AGENT_SHIM_REMOTE_CONTROL, AGENT_SHIM_HEADROOM, AGENT_SHIM_TRACK_USAGE, AGENT_SHIM_DELAY, AGENT_SHIM_PAUSE, AGENT_SHIM_EXPLAIN, AGENT_SHIM_ALLOW_AMBIENT_CREDENTIAL,
   AGENT_SHIM_CATEGORY_OVERRIDE, AGENT_SHIM_ENTRY_OVERRIDE, AGENT_SHIM_HOME,
   AGENT_SHIM_DEBUG (print stack traces), NO_COLOR. Booleans are true, false, 1 or 0.
 
@@ -147755,6 +147798,7 @@ function otherLaunchFlags(parsed) {
     ...parsed.claudeVersion === void 0 ? [] : ["--claude-version"],
     ...parsed.delay === void 0 ? [] : ["--delay"],
     ...parsed.pause === void 0 ? [] : ["--[no-]pause"],
+    ...parsed.explain === void 0 ? [] : ["--[no-]explain"],
     ...parsed.headroom === void 0 ? [] : ["--[no-]headroom"],
     ...parsed.trackUsage === void 0 ? [] : ["--[no-]track-usage"],
     ...parsed.skipPermissions === void 0 ? [] : ["--[no-]skip-permissions"],

package/dist/index.cjs

@@ -289,7 +289,9 @@ var init_schema = __esm({
       /** How long the launcher waits after its own output before it starts claude, so that output can be read before Claude Code takes over the terminal (`5s`, `500ms`). Applies only when a terminal is watching. */
       delay: import_zod.z.string().regex(DURATION_RE, "must be a duration such as 5s or 500ms").optional(),
       /** Whether the launcher waits for a key press after its own output before it starts claude. Takes the place of `delay` when both are set. Applies only when a terminal is watching. */
-      pause: import_zod.z.boolean().optional()
+      pause: import_zod.z.boolean().optional(),
+      /** Whether the launcher's report, for a launch that picks from a pool, lists every member the pick ranked with why each stands where it does, and not only the member it picked. */
+      explain: import_zod.z.boolean().optional()
     });
     CREDENTIAL_TARGETS = ["bearer", "apiKey", "oauthToken"];
     PROVIDER_CREDENTIAL_TARGETS = ["bearer", "apiKey"];
@@ -1398,6 +1400,9 @@ function flattenLayers(layers, options) {
       if (layer.launch.pause !== void 0) {
         launch.pause = layer.launch.pause;
       }
+      if (layer.launch.explain !== void 0) {
+        launch.explain = layer.launch.explain;
+      }
     }
     if (layer.entries === void 0) {
       continue;
@@ -2978,7 +2983,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.29.0",
+      version: "11.31.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>",
@@ -7578,7 +7583,8 @@ var init_argv = __esm({
       { flag: "--skip-permissions", key: "skipPermissions" },
       { flag: "--remote-control", key: "remoteControl" },
       { flag: "--wait", key: "wait" },
-      { flag: "--pause", key: "pause" }
+      { flag: "--pause", key: "pause" },
+      { flag: "--explain", key: "explain" }
     ];
     LAUNCHER_FLAG_NAMES = [
       ...VALUED_FLAGS,
@@ -7767,6 +7773,7 @@ function resolveLaunchFlags(params) {
     headroom: params.flags?.headroom ?? parseEnvBool("AGENT_SHIM_HEADROOM", params.env.AGENT_SHIM_HEADROOM) ?? params.cascade?.headroom ?? false,
     trackUsage: params.flags?.trackUsage ?? parseEnvBool("AGENT_SHIM_TRACK_USAGE", params.env.AGENT_SHIM_TRACK_USAGE) ?? params.cascade?.trackUsage ?? true,
     pause: params.flags?.pause ?? parseEnvBool("AGENT_SHIM_PAUSE", params.env.AGENT_SHIM_PAUSE) ?? params.cascade?.pause ?? false,
+    explain: params.flags?.explain ?? parseEnvBool("AGENT_SHIM_EXPLAIN", params.env.AGENT_SHIM_EXPLAIN) ?? params.cascade?.explain ?? false,
     delayMs: resolveDelayMs(params)
   };
 }
@@ -8106,6 +8113,18 @@ var init_hold = __esm({
   }
 });
 
+// src/usage/candidateText.ts
+function candidateHeading(candidate) {
+  const score = candidate.score === void 0 ? "" : ` score ${candidate.score.toFixed(2)}${candidate.scoreWindow === "fiveHour" ? " by 5h reset" : " by 7d reset"}`;
+  const dry = candidate.feasible ? "" : " (5h would run dry)";
+  return `[${candidate.class}${score}]${dry}`;
+}
+var init_candidateText = __esm({
+  "src/usage/candidateText.ts"() {
+    "use strict";
+  }
+});
+
 // src/launcher/launchReport.ts
 function poolDetail(pool) {
   const [reason] = pool.reasons;
@@ -8114,6 +8133,12 @@ function poolDetail(pool) {
   }
   return reason === void 0 ? {} : { detail: reason };
 }
+function rankingNotes(ranking, picked) {
+  return ranking.flatMap((candidate, index) => [
+    `${String(index + 1)}. ${candidate.identity} ${candidateHeading(candidate)}${candidate.identity === picked ? " (picked)" : ""}`,
+    `   ${candidate.reasons.join("; ")}`
+  ]);
+}
 function decisionRows(facts) {
   return [
     { label: "identity", value: facts.identity ?? "(none)", detail: facts.identitySource },
@@ -8121,7 +8146,8 @@ function decisionRows(facts) {
       {
         label: "pool",
         value: facts.pool.name,
-        ...poolDetail(facts.pool)
+        ...poolDetail(facts.pool),
+        ...facts.ranking === void 0 ? {} : { notes: rankingNotes(facts.ranking, facts.identity) }
       }
     ],
     ...facts.profile === void 0 ? [] : [{ label: "profile", value: facts.profile.name, detail: facts.profile.source }],
@@ -8156,6 +8182,7 @@ function noteRow(text) {
 var init_launchReport = __esm({
   "src/launcher/launchReport.ts"() {
     "use strict";
+    init_candidateText();
   }
 });
 
@@ -8268,6 +8295,9 @@ function resolveAntigravityConfig(config) {
     const target = overrides[tier];
     return target === void 0 ? ANTIGRAVITY_DEFAULT_TIER_MODELS[tier] : candidatesOf(target);
   };
+  if (!aliases.has(AUTO_ALIAS)) {
+    aliases.set(AUTO_ALIAS, [...new Set(CLAUDE_TIERS.flatMap(tierModel))]);
+  }
   return {
     mode: config?.mode ?? ANTIGRAVITY_DEFAULT_MODE,
     defaultModel: config?.defaultModel ?? ANTIGRAVITY_DEFAULT_MODEL,
@@ -8286,6 +8316,7 @@ function resolveAntigravityConfig(config) {
     }
   };
 }
+var AUTO_ALIAS;
 var init_translate = __esm({
   "src/antigravity/translate.ts"() {
     "use strict";
@@ -8293,6 +8324,7 @@ var init_translate = __esm({
     init_signatures();
     init_schema();
     init_anthropic();
+    AUTO_ALIAS = "auto";
   }
 });
 
@@ -8404,9 +8436,10 @@ function antigravityRows(provider) {
   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: labelOf(alias), description: `Alias for ${candidates.join(", then ")}`, behavesAs }];
+    const description = alias === AUTO_ALIAS ? `Routes each request to a backend model with quota left, best first (${String(candidates.length)} models)` : `Alias for ${candidates.join(", then ")}`;
+    return behavesAs === void 0 ? [] : [{ model: alias, label: labelOf(alias), description, behavesAs }];
   });
-  return [...tiers, ...aliases];
+  return [...aliases.filter((row) => row.model === AUTO_ALIAS), ...tiers, ...aliases.filter((row) => row.model !== AUTO_ALIAS)];
 }
 function codexRows(provider) {
   const config = resolveCodexConfig(provider.codex);
@@ -8541,6 +8574,7 @@ function resolvePoolLaunch(params) {
         identity: pick.identity,
         explanation: `pool ${poolName}: ${move}${pick.reasons.slice(0, REASONS_LOGGED).join("; ")}`,
         reasons: pick.reasons,
+        candidates: graph.ranking.candidates,
         ...movedOff === void 0 ? {} : { movedOff }
       };
     }
@@ -8715,7 +8749,8 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   }
   return {
     identityDecision: { ...decided, name: resolution.identity },
-    poolPick: { name: decided.pool, reasons: resolution.reasons, ...resolution.movedOff === void 0 ? {} : { movedOff: resolution.movedOff } }
+    poolPick: { name: decided.pool, reasons: resolution.reasons, ...resolution.movedOff === void 0 ? {} : { movedOff: resolution.movedOff } },
+    poolRanking: resolution.candidates
   };
 }
 function decideLaunch(params, readOnly) {
@@ -8742,7 +8777,7 @@ function decideLaunch(params, readOnly) {
       return trimmed === "" ? void 0 : trimmed;
     }
   });
-  const { identityDecision, poolPick } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
+  const { identityDecision, poolPick, poolRanking } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
   const farmIdentity = configDirEscapeHatchApplies ? void 0 : identityDecision.name;
   const farm = farmIdentity === void 0 ? void 0 : params.farm;
   if (!readOnly && farm !== void 0 && farmIdentity !== void 0) {
@@ -8878,6 +8913,7 @@ function decideLaunch(params, readOnly) {
       ...parsedArgv.headroom === void 0 ? {} : { headroom: parsedArgv.headroom },
       ...parsedArgv.trackUsage === void 0 ? {} : { trackUsage: parsedArgv.trackUsage },
       ...parsedArgv.pause === void 0 ? {} : { pause: parsedArgv.pause },
+      ...parsedArgv.explain === void 0 ? {} : { explain: parsedArgv.explain },
       ...parsedArgv.delay === void 0 ? {} : { delay: parsedArgv.delay }
     }
   });
@@ -8914,6 +8950,7 @@ function decideLaunch(params, readOnly) {
     parsedArgv,
     identityDecision,
     poolPick,
+    poolRanking,
     notes,
     configDirEscapeHatch: configDirEscapeHatchApplies,
     farmIdentity,
@@ -8934,12 +8971,13 @@ function prepareLaunch(params) {
   const { paths, proc, log } = params;
   const { env } = proc;
   const decided = decideLaunch(params, false);
-  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolPick, notes, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
+  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolPick, poolRanking, notes, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
   const rows = [
     ...decisionRows({
       identity: identityDecision.name,
       identitySource: identityDecision.source,
       pool: poolPick,
+      ranking: resolvedFlags.explain ? poolRanking : void 0,
       profile: configProfileDecision.name === void 0 ? void 0 : { name: configProfileDecision.name, source: configProfileDecision.source },
       provider: resolvedProvider === void 0 ? void 0 : { name: resolvedProvider.name, credential: `${resolvedProvider.credential.target} from ${describeSource(resolvedProvider.credential.source)}` },
       identityCredential: identityCredential === void 0 ? void 0 : `${identityCredential.target} from ${describeSource(identityCredential.source)}`
@@ -13949,6 +13987,9 @@ function applyProfileChange(paths, name, change) {
   if (change.launchPause !== void 0) {
     launchPatch.pause = change.launchPause;
   }
+  if (change.launchExplain !== void 0) {
+    launchPatch.explain = change.launchExplain;
+  }
   if (Object.keys(launchPatch).length > 0) {
     setProfileLaunchFlags(paths, name, launchPatch);
     touched = true;
@@ -16166,7 +16207,8 @@ var ConfigProfileSetInputSchema = import_zod24.z.strictObject({
     provider: import_zod24.z.union([import_zod24.z.string().min(1), import_zod24.z.literal(false)]).optional(),
     claudeVersion: import_zod24.z.union([import_zod24.z.string().min(1), import_zod24.z.literal(false)]).optional(),
     delay: import_zod24.z.union([import_zod24.z.string().regex(DURATION_RE), import_zod24.z.literal(false)]).optional(),
-    pause: import_zod24.z.boolean().optional()
+    pause: import_zod24.z.boolean().optional(),
+    explain: import_zod24.z.boolean().optional()
   }).optional()
 });
 var ConfigProfileSetOutputSchema = storedMutationOutput("profile", "updated", ProfileValueSchema);
@@ -16378,7 +16420,8 @@ function createConfigApiRouter(deps) {
               ...launch?.provider === void 0 ? {} : { launchProvider: launch.provider },
               ...launch?.claudeVersion === void 0 ? {} : { launchClaudeVersion: launch.claudeVersion },
               ...launch?.delay === void 0 ? {} : { launchDelay: launch.delay },
-              ...launch?.pause === void 0 ? {} : { launchPause: launch.pause }
+              ...launch?.pause === void 0 ? {} : { launchPause: launch.pause },
+              ...launch?.explain === void 0 ? {} : { launchExplain: launch.explain }
             });
             return { action: "updated", kind: "profile", name: input.name, value: profileValue(input.name, paths) };
           })
@@ -16688,6 +16731,7 @@ var LaunchFlagsSchema = import_zod26.z.strictObject({
   headroom: import_zod26.z.boolean(),
   trackUsage: import_zod26.z.boolean(),
   pause: import_zod26.z.boolean(),
+  explain: import_zod26.z.boolean(),
   /** How long the launch waits after its own output before it starts claude, in milliseconds. */
   delayMs: import_zod26.z.number()
 });

package/dist/index.mjs

@@ -267,7 +267,9 @@ var init_schema = __esm({
       /** How long the launcher waits after its own output before it starts claude, so that output can be read before Claude Code takes over the terminal (`5s`, `500ms`). Applies only when a terminal is watching. */
       delay: z.string().regex(DURATION_RE, "must be a duration such as 5s or 500ms").optional(),
       /** Whether the launcher waits for a key press after its own output before it starts claude. Takes the place of `delay` when both are set. Applies only when a terminal is watching. */
-      pause: z.boolean().optional()
+      pause: z.boolean().optional(),
+      /** Whether the launcher's report, for a launch that picks from a pool, lists every member the pick ranked with why each stands where it does, and not only the member it picked. */
+      explain: z.boolean().optional()
     });
     CREDENTIAL_TARGETS = ["bearer", "apiKey", "oauthToken"];
     PROVIDER_CREDENTIAL_TARGETS = ["bearer", "apiKey"];
@@ -1376,6 +1378,9 @@ function flattenLayers(layers, options) {
       if (layer.launch.pause !== void 0) {
         launch.pause = layer.launch.pause;
       }
+      if (layer.launch.explain !== void 0) {
+        launch.explain = layer.launch.explain;
+      }
     }
     if (layer.entries === void 0) {
       continue;
@@ -2954,7 +2959,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.29.0",
+      version: "11.31.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>",
@@ -7551,7 +7556,8 @@ var init_argv = __esm({
       { flag: "--skip-permissions", key: "skipPermissions" },
       { flag: "--remote-control", key: "remoteControl" },
       { flag: "--wait", key: "wait" },
-      { flag: "--pause", key: "pause" }
+      { flag: "--pause", key: "pause" },
+      { flag: "--explain", key: "explain" }
     ];
     LAUNCHER_FLAG_NAMES = [
       ...VALUED_FLAGS,
@@ -7741,6 +7747,7 @@ function resolveLaunchFlags(params) {
     headroom: params.flags?.headroom ?? parseEnvBool("AGENT_SHIM_HEADROOM", params.env.AGENT_SHIM_HEADROOM) ?? params.cascade?.headroom ?? false,
     trackUsage: params.flags?.trackUsage ?? parseEnvBool("AGENT_SHIM_TRACK_USAGE", params.env.AGENT_SHIM_TRACK_USAGE) ?? params.cascade?.trackUsage ?? true,
     pause: params.flags?.pause ?? parseEnvBool("AGENT_SHIM_PAUSE", params.env.AGENT_SHIM_PAUSE) ?? params.cascade?.pause ?? false,
+    explain: params.flags?.explain ?? parseEnvBool("AGENT_SHIM_EXPLAIN", params.env.AGENT_SHIM_EXPLAIN) ?? params.cascade?.explain ?? false,
     delayMs: resolveDelayMs(params)
   };
 }
@@ -8078,6 +8085,18 @@ var init_hold = __esm({
   }
 });
 
+// src/usage/candidateText.ts
+function candidateHeading(candidate) {
+  const score = candidate.score === void 0 ? "" : ` score ${candidate.score.toFixed(2)}${candidate.scoreWindow === "fiveHour" ? " by 5h reset" : " by 7d reset"}`;
+  const dry = candidate.feasible ? "" : " (5h would run dry)";
+  return `[${candidate.class}${score}]${dry}`;
+}
+var init_candidateText = __esm({
+  "src/usage/candidateText.ts"() {
+    "use strict";
+  }
+});
+
 // src/launcher/launchReport.ts
 function poolDetail(pool) {
   const [reason] = pool.reasons;
@@ -8086,6 +8105,12 @@ function poolDetail(pool) {
   }
   return reason === void 0 ? {} : { detail: reason };
 }
+function rankingNotes(ranking, picked) {
+  return ranking.flatMap((candidate, index) => [
+    `${String(index + 1)}. ${candidate.identity} ${candidateHeading(candidate)}${candidate.identity === picked ? " (picked)" : ""}`,
+    `   ${candidate.reasons.join("; ")}`
+  ]);
+}
 function decisionRows(facts) {
   return [
     { label: "identity", value: facts.identity ?? "(none)", detail: facts.identitySource },
@@ -8093,7 +8118,8 @@ function decisionRows(facts) {
       {
         label: "pool",
         value: facts.pool.name,
-        ...poolDetail(facts.pool)
+        ...poolDetail(facts.pool),
+        ...facts.ranking === void 0 ? {} : { notes: rankingNotes(facts.ranking, facts.identity) }
       }
     ],
     ...facts.profile === void 0 ? [] : [{ label: "profile", value: facts.profile.name, detail: facts.profile.source }],
@@ -8128,6 +8154,7 @@ function noteRow(text) {
 var init_launchReport = __esm({
   "src/launcher/launchReport.ts"() {
     "use strict";
+    init_candidateText();
   }
 });
 
@@ -8240,6 +8267,9 @@ function resolveAntigravityConfig(config) {
     const target = overrides[tier];
     return target === void 0 ? ANTIGRAVITY_DEFAULT_TIER_MODELS[tier] : candidatesOf(target);
   };
+  if (!aliases.has(AUTO_ALIAS)) {
+    aliases.set(AUTO_ALIAS, [...new Set(CLAUDE_TIERS.flatMap(tierModel))]);
+  }
   return {
     mode: config?.mode ?? ANTIGRAVITY_DEFAULT_MODE,
     defaultModel: config?.defaultModel ?? ANTIGRAVITY_DEFAULT_MODEL,
@@ -8258,6 +8288,7 @@ function resolveAntigravityConfig(config) {
     }
   };
 }
+var AUTO_ALIAS;
 var init_translate = __esm({
   "src/antigravity/translate.ts"() {
     "use strict";
@@ -8265,6 +8296,7 @@ var init_translate = __esm({
     init_signatures();
     init_schema();
     init_anthropic();
+    AUTO_ALIAS = "auto";
   }
 });
 
@@ -8376,9 +8408,10 @@ function antigravityRows(provider) {
   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: labelOf(alias), description: `Alias for ${candidates.join(", then ")}`, behavesAs }];
+    const description = alias === AUTO_ALIAS ? `Routes each request to a backend model with quota left, best first (${String(candidates.length)} models)` : `Alias for ${candidates.join(", then ")}`;
+    return behavesAs === void 0 ? [] : [{ model: alias, label: labelOf(alias), description, behavesAs }];
   });
-  return [...tiers, ...aliases];
+  return [...aliases.filter((row) => row.model === AUTO_ALIAS), ...tiers, ...aliases.filter((row) => row.model !== AUTO_ALIAS)];
 }
 function codexRows(provider) {
   const config = resolveCodexConfig(provider.codex);
@@ -8513,6 +8546,7 @@ function resolvePoolLaunch(params) {
         identity: pick.identity,
         explanation: `pool ${poolName}: ${move}${pick.reasons.slice(0, REASONS_LOGGED).join("; ")}`,
         reasons: pick.reasons,
+        candidates: graph.ranking.candidates,
         ...movedOff === void 0 ? {} : { movedOff }
       };
     }
@@ -8689,7 +8723,8 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   }
   return {
     identityDecision: { ...decided, name: resolution.identity },
-    poolPick: { name: decided.pool, reasons: resolution.reasons, ...resolution.movedOff === void 0 ? {} : { movedOff: resolution.movedOff } }
+    poolPick: { name: decided.pool, reasons: resolution.reasons, ...resolution.movedOff === void 0 ? {} : { movedOff: resolution.movedOff } },
+    poolRanking: resolution.candidates
   };
 }
 function decideLaunch(params, readOnly) {
@@ -8716,7 +8751,7 @@ function decideLaunch(params, readOnly) {
       return trimmed === "" ? void 0 : trimmed;
     }
   });
-  const { identityDecision, poolPick } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
+  const { identityDecision, poolPick, poolRanking } = pickFromPool(decidedIdentity, params, parsedArgv, readOnly);
   const farmIdentity = configDirEscapeHatchApplies ? void 0 : identityDecision.name;
   const farm = farmIdentity === void 0 ? void 0 : params.farm;
   if (!readOnly && farm !== void 0 && farmIdentity !== void 0) {
@@ -8852,6 +8887,7 @@ function decideLaunch(params, readOnly) {
       ...parsedArgv.headroom === void 0 ? {} : { headroom: parsedArgv.headroom },
       ...parsedArgv.trackUsage === void 0 ? {} : { trackUsage: parsedArgv.trackUsage },
       ...parsedArgv.pause === void 0 ? {} : { pause: parsedArgv.pause },
+      ...parsedArgv.explain === void 0 ? {} : { explain: parsedArgv.explain },
       ...parsedArgv.delay === void 0 ? {} : { delay: parsedArgv.delay }
     }
   });
@@ -8888,6 +8924,7 @@ function decideLaunch(params, readOnly) {
     parsedArgv,
     identityDecision,
     poolPick,
+    poolRanking,
     notes,
     configDirEscapeHatch: configDirEscapeHatchApplies,
     farmIdentity,
@@ -8908,12 +8945,13 @@ function prepareLaunch(params) {
   const { paths, proc, log } = params;
   const { env } = proc;
   const decided = decideLaunch(params, false);
-  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolPick, notes, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
+  const { identityDecision, configProfileDecision, resolvedProvider, identityCredential, poolPick, poolRanking, notes, flags: resolvedFlags, args: finalArgv, configDirEscapeHatch: configDirEscapeHatchApplies, decision } = decided;
   const rows = [
     ...decisionRows({
       identity: identityDecision.name,
       identitySource: identityDecision.source,
       pool: poolPick,
+      ranking: resolvedFlags.explain ? poolRanking : void 0,
       profile: configProfileDecision.name === void 0 ? void 0 : { name: configProfileDecision.name, source: configProfileDecision.source },
       provider: resolvedProvider === void 0 ? void 0 : { name: resolvedProvider.name, credential: `${resolvedProvider.credential.target} from ${describeSource(resolvedProvider.credential.source)}` },
       identityCredential: identityCredential === void 0 ? void 0 : `${identityCredential.target} from ${describeSource(identityCredential.source)}`
@@ -13536,6 +13574,9 @@ function applyProfileChange(paths, name, change) {
   if (change.launchPause !== void 0) {
     launchPatch.pause = change.launchPause;
   }
+  if (change.launchExplain !== void 0) {
+    launchPatch.explain = change.launchExplain;
+  }
   if (Object.keys(launchPatch).length > 0) {
     setProfileLaunchFlags(paths, name, launchPatch);
     touched = true;
@@ -15753,7 +15794,8 @@ var ConfigProfileSetInputSchema = z24.strictObject({
     provider: z24.union([z24.string().min(1), z24.literal(false)]).optional(),
     claudeVersion: z24.union([z24.string().min(1), z24.literal(false)]).optional(),
     delay: z24.union([z24.string().regex(DURATION_RE), z24.literal(false)]).optional(),
-    pause: z24.boolean().optional()
+    pause: z24.boolean().optional(),
+    explain: z24.boolean().optional()
   }).optional()
 });
 var ConfigProfileSetOutputSchema = storedMutationOutput("profile", "updated", ProfileValueSchema);
@@ -15965,7 +16007,8 @@ function createConfigApiRouter(deps) {
               ...launch?.provider === void 0 ? {} : { launchProvider: launch.provider },
               ...launch?.claudeVersion === void 0 ? {} : { launchClaudeVersion: launch.claudeVersion },
               ...launch?.delay === void 0 ? {} : { launchDelay: launch.delay },
-              ...launch?.pause === void 0 ? {} : { launchPause: launch.pause }
+              ...launch?.pause === void 0 ? {} : { launchPause: launch.pause },
+              ...launch?.explain === void 0 ? {} : { launchExplain: launch.explain }
             });
             return { action: "updated", kind: "profile", name: input.name, value: profileValue(input.name, paths) };
           })
@@ -16275,6 +16318,7 @@ var LaunchFlagsSchema = z26.strictObject({
   headroom: z26.boolean(),
   trackUsage: z26.boolean(),
   pause: z26.boolean(),
+  explain: z26.boolean(),
   /** How long the launch waits after its own output before it starts claude, in milliseconds. */
   delayMs: z26.number()
 });

package/dist/types/index.d.ts

@@ -278,6 +278,7 @@ declare const LaunchSchema: z.ZodObject<{
     claudeVersion: z.ZodOptional<z.ZodString>;
     delay: z.ZodOptional<z.ZodString>;
     pause: z.ZodOptional<z.ZodBoolean>;
+    explain: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 type LaunchFlags = z.infer<typeof LaunchSchema>;
 /**
@@ -861,6 +862,7 @@ declare const ConfigProfileSchema: z.ZodObject<{
         claudeVersion: z.ZodOptional<z.ZodString>;
         delay: z.ZodOptional<z.ZodString>;
         pause: z.ZodOptional<z.ZodBoolean>;
+        explain: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type ConfigProfile = z.infer<typeof ConfigProfileSchema>;
@@ -1069,6 +1071,7 @@ declare const DirectoryRuleSchema: z.ZodObject<{
         claudeVersion: z.ZodOptional<z.ZodString>;
         delay: z.ZodOptional<z.ZodString>;
         pause: z.ZodOptional<z.ZodBoolean>;
+        explain: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     path: z.ZodString;
     configProfile: z.ZodOptional<z.ZodString>;
@@ -1250,6 +1253,7 @@ declare const DirectoryRulesSchema: z.ZodObject<{
             claudeVersion: z.ZodOptional<z.ZodString>;
             delay: z.ZodOptional<z.ZodString>;
             pause: z.ZodOptional<z.ZodBoolean>;
+            explain: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         path: z.ZodString;
         configProfile: z.ZodOptional<z.ZodString>;
@@ -1432,6 +1436,7 @@ declare const PortableConfigSchema: z.ZodObject<{
         claudeVersion: z.ZodOptional<z.ZodString>;
         delay: z.ZodOptional<z.ZodString>;
         pause: z.ZodOptional<z.ZodBoolean>;
+        explain: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     configProfile: z.ZodOptional<z.ZodString>;
     identity: z.ZodOptional<z.ZodString>;
@@ -1638,6 +1643,7 @@ declare const GlobalConfigSchema: z.ZodObject<{
         claudeVersion: z.ZodOptional<z.ZodString>;
         delay: z.ZodOptional<z.ZodString>;
         pause: z.ZodOptional<z.ZodBoolean>;
+        explain: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     headroom: z.ZodOptional<z.ZodObject<{
         source: z.ZodOptional<z.ZodString>;
@@ -5990,6 +5996,7 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
                         delay: zod.ZodOptional<zod.ZodString>;
                         pause: zod.ZodOptional<zod.ZodBoolean>;
+                        explain: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                 }, zod_v4_core.$strict>;
             }, zod_v4_core.$strict>, MergedErrorMap<$ErrorMap, TErrorMap>>;
@@ -6008,6 +6015,7 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                     claudeVersion: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
                     delay: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
                     pause: zod.ZodOptional<zod.ZodBoolean>;
+                    explain: zod.ZodOptional<zod.ZodBoolean>;
                 }, zod_v4_core.$strict>>;
             }, zod_v4_core.$strict>, zod.ZodObject<{
                 action: zod.ZodLiteral<"updated">;
@@ -6113,6 +6121,7 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
                         delay: zod.ZodOptional<zod.ZodString>;
                         pause: zod.ZodOptional<zod.ZodBoolean>;
+                        explain: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                 }, zod_v4_core.$strict>;
             }, zod_v4_core.$strict>, MergedErrorMap<$ErrorMap, TErrorMap>>;
@@ -6715,6 +6724,7 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
                         delay: zod.ZodOptional<zod.ZodString>;
                         pause: zod.ZodOptional<zod.ZodBoolean>;
+                        explain: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                     path: zod.ZodString;
                     configProfile: zod.ZodOptional<zod.ZodString>;
@@ -6901,6 +6911,7 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
                         delay: zod.ZodOptional<zod.ZodString>;
                         pause: zod.ZodOptional<zod.ZodBoolean>;
+                        explain: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                     path: zod.ZodString;
                     configProfile: zod.ZodOptional<zod.ZodString>;
@@ -7232,6 +7243,8 @@ interface ResolvedLaunchFlags {
     readonly trackUsage: boolean;
     /** Whether the launcher waits for a key press after its own output before it starts claude. */
     readonly pause: boolean;
+    /** Whether the launch's report lists every pool member the pick ranked and why, and not only the one picked. */
+    readonly explain: boolean;
     /** How long the launcher waits after its own output before it starts claude, in milliseconds; zero for no wait. */
     readonly delayMs: number;
 }
@@ -7524,6 +7537,7 @@ declare function createLaunchApiRouter(deps: LaunchApiDeps): {
                 headroom: zod.ZodBoolean;
                 trackUsage: zod.ZodBoolean;
                 pause: zod.ZodBoolean;
+                explain: zod.ZodBoolean;
                 delayMs: zod.ZodNumber;
             }, zod_v4_core.$strict>;
             claudeVersion: zod.ZodOptional<zod.ZodObject<{
@@ -8642,6 +8656,7 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                 headroom: zod.ZodBoolean;
                 trackUsage: zod.ZodBoolean;
                 pause: zod.ZodBoolean;
+                explain: zod.ZodBoolean;
                 delayMs: zod.ZodNumber;
             }, zod_v4_core.$strict>;
             claudeVersion: zod.ZodOptional<zod.ZodObject<{
@@ -9012,6 +9027,7 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
                         delay: zod.ZodOptional<zod.ZodString>;
                         pause: zod.ZodOptional<zod.ZodBoolean>;
+                        explain: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                 }, zod_v4_core.$strict>;
             }, zod_v4_core.$strict>, MergedErrorMap<$ErrorMap, TErrorMap>>;
@@ -9030,6 +9046,7 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                     claudeVersion: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
                     delay: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
                     pause: zod.ZodOptional<zod.ZodBoolean>;
+                    explain: zod.ZodOptional<zod.ZodBoolean>;
                 }, zod_v4_core.$strict>>;
             }, zod_v4_core.$strict>, zod.ZodObject<{
                 action: zod.ZodLiteral<"updated">;
@@ -9135,6 +9152,7 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
                         delay: zod.ZodOptional<zod.ZodString>;
                         pause: zod.ZodOptional<zod.ZodBoolean>;
+                        explain: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                 }, zod_v4_core.$strict>;
             }, zod_v4_core.$strict>, MergedErrorMap<$ErrorMap, TErrorMap>>;
@@ -9737,6 +9755,7 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
                         delay: zod.ZodOptional<zod.ZodString>;
                         pause: zod.ZodOptional<zod.ZodBoolean>;
+                        explain: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                     path: zod.ZodString;
                     configProfile: zod.ZodOptional<zod.ZodString>;
@@ -9923,6 +9942,7 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
                         delay: zod.ZodOptional<zod.ZodString>;
                         pause: zod.ZodOptional<zod.ZodBoolean>;
+                        explain: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                     path: zod.ZodString;
                     configProfile: zod.ZodOptional<zod.ZodString>;
@@ -11149,6 +11169,7 @@ declare const ConfigProfileAddOutputSchema: z.ZodObject<{
             claudeVersion: z.ZodOptional<z.ZodString>;
             delay: z.ZodOptional<z.ZodString>;
             pause: z.ZodOptional<z.ZodBoolean>;
+            explain: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
 }, z.core.$strict>;
@@ -11168,6 +11189,7 @@ declare const ConfigProfileSetInputSchema: z.ZodObject<{
         claudeVersion: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
         delay: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
         pause: z.ZodOptional<z.ZodBoolean>;
+        explain: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 declare const ConfigProfileSetOutputSchema: z.ZodObject<{
@@ -11274,6 +11296,7 @@ declare const ConfigProfileSetOutputSchema: z.ZodObject<{
             claudeVersion: z.ZodOptional<z.ZodString>;
             delay: z.ZodOptional<z.ZodString>;
             pause: z.ZodOptional<z.ZodBoolean>;
+            explain: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
 }, z.core.$strict>;
@@ -11878,6 +11901,7 @@ declare const ConfigRuleAddOutputSchema: z.ZodObject<{
             claudeVersion: z.ZodOptional<z.ZodString>;
             delay: z.ZodOptional<z.ZodString>;
             pause: z.ZodOptional<z.ZodBoolean>;
+            explain: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         path: z.ZodString;
         configProfile: z.ZodOptional<z.ZodString>;
@@ -12066,6 +12090,7 @@ declare const ConfigRuleSetOutputSchema: z.ZodObject<{
             claudeVersion: z.ZodOptional<z.ZodString>;
             delay: z.ZodOptional<z.ZodString>;
             pause: z.ZodOptional<z.ZodBoolean>;
+            explain: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         path: z.ZodString;
         configProfile: z.ZodOptional<z.ZodString>;
@@ -12553,6 +12578,7 @@ declare const LaunchResolveOutputSchema: z.ZodObject<{
         headroom: z.ZodBoolean;
         trackUsage: z.ZodBoolean;
         pause: z.ZodBoolean;
+        explain: z.ZodBoolean;
         delayMs: z.ZodNumber;
     }, z.core.$strict>;
     claudeVersion: z.ZodOptional<z.ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-use",
-  "version": "11.29.0",
+  "version": "11.31.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>",