claude-use 2.7.0 → 2.8.0

package/README.md

@@ -84,6 +84,9 @@ claude-use provider remove <name>
 
 claude-use headroom status
 
+claude @<identity> --headroom            # one launch routed through headroom
+claude --no-headroom                       # one launch routed direct, overriding every layer
+
 claude-use rules add <path> [--profile <name>] [--identity <name>]
 claude-use rules list
 claude-use rules remove <path>

package/dist/cli.cjs

@@ -239649,7 +239649,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "claude-use",
-  version: "2.7.0",
+  version: "2.8.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: "Apache-2.0",
   author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -266394,6 +266394,7 @@ function parseLauncherArgv(argv) {
   const remaining = hasIdentity ? argv.slice(1) : argv;
   let configProfile;
   let provider;
+  let headroom;
   const categoryFlags = [];
   const shareFlags = [];
   const hideFlags = [];
@@ -266403,6 +266404,10 @@ function parseLauncherArgv(argv) {
     if (token === void 0) {
       continue;
     }
+    if (token === "--headroom" || token === "--no-headroom") {
+      headroom = token === "--headroom";
+      continue;
+    }
     const matched = matchValuedFlag(token);
     if (matched === void 0) {
       rest.push(token);
@@ -266436,6 +266441,7 @@ function parseLauncherArgv(argv) {
     ...hasIdentity ? { identity: first.slice(1) } : {},
     ...configProfile === void 0 ? {} : { configProfile },
     ...provider === void 0 ? {} : { provider },
+    ...headroom === void 0 ? {} : { headroom },
     categoryFlags,
     shareFlags,
     hideFlags,
@@ -266557,7 +266563,8 @@ function resolveLaunchFlags(params) {
   return {
     skipPermissions: params.cascade?.skipPermissions === true || isEnvFlagSet(params.env.CLAUDE_USE_SKIP_PERMISSIONS),
     remoteControl: params.cascade?.remoteControl === true || isEnvFlagSet(params.env.CLAUDE_USE_REMOTE_CONTROL),
-    headroom: params.cascade?.headroom === true || isEnvFlagSet(params.env.CLAUDE_USE_HEADROOM)
+    // Precedence: an explicit --headroom/--no-headroom flag decides outright, then the CLAUDE_USE_HEADROOM escape hatch, then the cascade. The flag outranks the environment variable because it is the more deliberate of the two one-off forms (typed on this very command line, not inherited from a shell profile).
+    headroom: params.headroomFlag ?? (isEnvFlagSet(params.env.CLAUDE_USE_HEADROOM) || params.cascade?.headroom === true)
   };
 }
 function buildFlagArgs(flags) {
@@ -266784,7 +266791,11 @@ function runLauncher(params) {
     cascadeLaunch = flattenLayers(assembleCascade(params.farm.loadCascade(configProfileDecision.name, cliOverride)).layers, { home: params.farm.home }).launch;
   }
   const discovered = params.resolveClaudeBinary();
-  const resolvedFlags = resolveLaunchFlags({ env, ...cascadeLaunch === void 0 ? {} : { cascade: cascadeLaunch } });
+  const resolvedFlags = resolveLaunchFlags({
+    env,
+    ...cascadeLaunch === void 0 ? {} : { cascade: cascadeLaunch },
+    ...parsedArgv.headroom === void 0 ? {} : { headroomFlag: parsedArgv.headroom }
+  });
   let headroom;
   const headroomPort = params.headroom;
   if (resolvedFlags.headroom && headroomPort !== void 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-use",
-  "version": "2.7.0",
+  "version": "2.8.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": "Apache-2.0",
   "author": "Joseph Mearman <joseph@mearman.co.uk>",