impel-cli 0.16.1 → 0.16.3

package/README.md

@@ -551,19 +551,40 @@ impel codex exec --json "review the current diff"
 switch their native profiles in place; the isolated launchers are the safer
 default when personal and Impel sessions should coexist.
 
+Every Impel-managed Claude configuration uses the same strict sandbox defaults:
+the isolated `impel claude` profile, each tenant's Claude Desktop Code profile,
+the native profile while `impel use gateway claude` is active, and branded
+gateway-only CLI profiles. App config version 14 also pins managed Claude
+Desktop profiles to third-party deployment mode, enables the 3P Chat tab so
+Code's "Back to Claude" route has a valid destination, and removes the unusable
+Claude.ai sign-in path. Existing tenant profiles refresh onto these policies
+after the CLI update.
+
 ### `impel use gateway [claude|codex|all]`  (alias `impel on`)
 
 Turns **on** gateway mode for the given tool (default `all`). Requires `impel auth`
 first.
 
 **Claude Code** — merges into `~/.claude/settings.json` (creating it if needed,
-leaving every other key — permissions, hooks, other env vars — untouched):
+leaving permissions, hooks, other env vars, and custom sandbox filesystem/network
+rules untouched). Gateway mode enables Claude's strict auto-allow sandbox by
+default: Bash runs inside the OS sandbox without routine prompts, the
+`dangerouslyDisableSandbox` escape hatch is disabled, and supported platforms
+fail closed if isolation cannot initialize. Native Windows keeps startup
+available because Claude's sandbox is supported only on macOS, Linux, and WSL2.
 
 ```json
 {
   "apiKeyHelper": "impel token",
   "env": {
     "ANTHROPIC_BASE_URL": "https://gateway.useimpel.com/anthropic"
+  },
+  "sandbox": {
+    "enabled": true,
+    "failIfUnavailable": true,
+    "autoAllowBashIfSandboxed": true,
+    "allowUnsandboxedCommands": false,
+    "excludedCommands": []
   }
 }
 ```
@@ -597,9 +618,9 @@ refresh_interval_ms = 300000
 ```
 
 Before overwriting anything, `impel` **backs up** what was there (any prior
-`apiKeyHelper` / `ANTHROPIC_BASE_URL`, and the prior Codex `model_provider`
-value) into `~/.config/impel/config.json`, so `impel use account` can restore it
-exactly. If `config.toml` already has a `[model_providers.impel]` table that
+`apiKeyHelper`, `ANTHROPIC_BASE_URL`, Claude sandbox policy, and the prior Codex
+`model_provider` value) into `~/.config/impel/config.json`, so `impel use account`
+can restore it exactly. If `config.toml` already has a `[model_providers.impel]` table that
 wasn't written by this tool, `impel` refuses to touch the file and tells you to
 resolve it manually rather than risk emitting invalid/duplicate TOML.
 
@@ -908,7 +929,7 @@ impel status             # see where each tool stands right now
 ```
 
 How the clean revert is guaranteed: `impel on` records the pre-existing values
-(your own `apiKeyHelper` / `ANTHROPIC_BASE_URL`, and Codex's prior
+(your own `apiKeyHelper` / `ANTHROPIC_BASE_URL` / Claude sandbox policy, and Codex's prior
 `model_provider`) into `~/.config/impel/config.json` **before** overwriting them,
 and only ever captures a real *account-mode* value (re-running `impel on` never
 clobbers the backup with Impel's own values). `impel off` removes only keys that
@@ -916,8 +937,9 @@ still point at Impel and restores those backups — so a full `on` → `off`
 round-trip leaves `settings.json` and `config.toml` byte-for-byte back to where
 they started, with all your unrelated keys and tables intact.
 
-If you'd rather revert by hand: delete `apiKeyHelper` + the Impel
-`ANTHROPIC_BASE_URL` from `~/.claude/settings.json`; delete the block between the
+If you'd rather revert by hand: delete `apiKeyHelper`, the Impel
+`ANTHROPIC_BASE_URL`, and the Impel-managed sandbox keys from
+`~/.claude/settings.json`; delete the block between the
 `# >>> impel-cli managed block ... >>>` / `# <<< impel-cli managed block <<<`
 markers in `~/.codex/config.toml` and reset `model_provider`; and
 `rm -rf ~/.config/impel` to forget the PAT + gateway entirely.
@@ -969,6 +991,12 @@ OpenAI Responses front door for SDK/Eve traffic and may normalize the body
 - https://developers.openai.com/codex/auth
 - https://developers.openai.com/codex/ide
 
+## Sources consulted for the Claude sandbox config
+
+- https://code.claude.com/docs/en/settings#sandbox-settings
+- https://code.claude.com/docs/en/sandboxing#configure-the-sandbox-for-your-organization
+- https://github.com/anthropics/claude-code/blob/v2.1.205/examples/settings/settings-bash-sandbox.json
+
 ## Sources consulted for concurrent tenant apps
 
 - Electron v43.1.0 release: https://github.com/electron/electron/releases/tag/v43.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "impel-cli",
-  "version": "0.16.1",
+  "version": "0.16.3",
   "description": "Configure Claude Code and Codex CLI to talk to Impel's gateway, authenticated by an Impel Personal Access Token",
   "type": "module",
   "bin": {

package/src/apps.js

@@ -13,6 +13,7 @@ import { normalizeTenantId } from "./tenants.js";
 import { impelCliInvocation } from "./selfInvocation.js";
 import { crossAppModelsEnabled, redactSecretText } from "./config.js";
 import { ADHOC_IDENTITY, codesignIdentityArgs, desiredSigningMode, resolveSigningIdentity } from "./codesign.js";
+import { applyImpelClaudeSandbox } from "./claudeSandbox.js";
 
 export const CLAUDE_CONFIG_ID = "1ced0000-0000-4000-8000-000000000001";
 const CHATGPT_CONFIG_START = "# >>> impel app managed gateway >>>";
@@ -162,7 +163,7 @@ export function managedAppIdentity(target, tenantId = null, tenantName = null) {
 
 // Bump when the written config/manifest schema changes; a mismatch forces the
 // slow open path (and thus a full config rewrite) after a CLI update.
-export const CURRENT_CONFIG_VERSION = 11;
+export const CURRENT_CONFIG_VERSION = 14;
 
 // Identifies the bundle-BUILDING logic — the asar patches, plist rewrites,
 // helper rebranding, and signing. A vendored bundle is rebuilt only when this
@@ -171,7 +172,7 @@ export const CURRENT_CONFIG_VERSION = 11;
 // — which is what made every `impel update` re-trigger macOS permission
 // prompts. Bump this ONLY when a code change alters the bytes of a built
 // bundle; leave it alone for changes that don't touch bundle contents.
-export const BUNDLE_BUILD_FINGERPRINT = "bundle-2026-07-17.1";
+export const BUNDLE_BUILD_FINGERPRINT = "bundle-2026-07-19.1";
 
 /** Parse the tenant's install manifest, or null when absent/corrupt. */
 export function readTenantManifest(homeDir = os.homedir(), tenantId = null) {
@@ -206,8 +207,24 @@ export function readBundleCompatibility(launcher) {
  * closed, so a routine CLI update that doesn't change bundle bytes must leave
  * the installed bundles — and their macOS permission grants — untouched.
  */
-export function bundleIsCurrent(status, { signingMode = desiredSigningMode() } = {}) {
+export function bundleIsCurrent(status, {
+  signingMode = desiredSigningMode(),
+  platform = process.platform,
+  osRelease = os.release(),
+} = {}) {
   if (!status.launcherInstalled || !status.vendorPath || !status.vendorVersion) return false;
+  // macOS 26 (Darwin 25) refuses to launch bundles whose CFBundleExecutable is
+  // a script (-10669). A wrapper in that state — either target — is broken
+  // regardless of its fingerprint; reporting it stale makes the next
+  // install/open rebuild it into a launchable layout (e.g. the ChatGPT
+  // launch-host layout once a compiler exists), with no fingerprint bump.
+  if (
+    platform === "darwin"
+    && Number.parseInt(osRelease, 10) >= 25
+    && !wrapperLaunchesOnTahoe(status)
+  ) {
+    return false;
+  }
   const compatibility = readBundleCompatibility(status.launcher);
   return Boolean(
     compatibility
@@ -237,6 +254,28 @@ export function bundleIsCurrent(status, { signingMode = desiredSigningMode() } =
   );
 }
 
+/**
+ * Whether a wrapper bundle's main executable is one macOS 26 will launch.
+ * The ChatGPT wrapper must be on the launch-host layout: its script fallback
+ * is exactly what Tahoe refuses (-10669). The Claude wrapper retains the
+ * vendor's Mach-O executable, so its only unlaunchable state is that
+ * executable going missing — the Mach-O bytes themselves are not probed
+ * because test fixtures legitimately stand in scripts for the vendor binary.
+ */
+function wrapperLaunchesOnTahoe(status) {
+  try {
+    const plist = fs.readFileSync(path.join(status.launcher, "Contents", "Info.plist"), "utf8");
+    const executable = plist.match(/<key>CFBundleExecutable<\/key>\s*<string>([^<]+)<\/string>/u)?.[1];
+    if (!executable) return false;
+    const file = path.join(status.launcher, "Contents", "MacOS", executable);
+    if (!fs.existsSync(file)) return false;
+    if (status.target === "chatgpt") return executable === "launch-host" && isMachO(file);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function managedClaudeRendererMatchesCompatibility(status, compatibility) {
   try {
     const renderer = compatibility.rendererAssets?.agentMentions;
@@ -576,6 +615,7 @@ export function installManagedAppFiles({
     if (target === "claude") {
       migrateLegacyClaudeAppSessions(paths.claude.userData, homeDir);
       writeClaudeDefaultApp(paths);
+      writeClaudeCodeSettings(paths);
       writeClaudeConfig(paths, config, models);
     }
     else writeChatGPTConfig(paths, config, models, vendorCodexModels, chatgptInvocations);
@@ -851,6 +891,17 @@ function writeClaudeConfig(paths, config, models) {
     inferenceGatewayAuthScheme: "bearer",
     modelDiscoveryEnabled: false,
     inferenceModels: claudeModels,
+    // 3P builds leave Chat unavailable unless the administrator opts in. The
+    // Code install/disabled screen's "Back to Claude" link targets the Chat
+    // root; without this key the root router selects Code again and strands
+    // gateway users in a loop even though inference is healthy.
+    chatTabEnabled: true,
+    // Managed flat key (maps to authentication.disableClaudeAiSignIn, vendor
+    // 1.3834.0+): hides the Claude.ai sign-in option and keeps the app in 3P
+    // mode even when the persisted deploymentMode is missing or "1p". Claude.ai
+    // account login is a dead end for gateway profiles anyway — the server
+    // rejects it with custom_3p_not_available.
+    disableDeploymentModeChooser: true,
   };
   writeAtomic(path.join(dir, `${CLAUDE_CONFIG_ID}.json`), JSON.stringify(body, null, 2) + "\n", 0o600);
   writeAtomic(path.join(dir, "_meta.json"), JSON.stringify({
@@ -859,6 +910,23 @@ function writeClaudeConfig(paths, config, models) {
   }, null, 2) + "\n", 0o600);
 }
 
+function writeClaudeCodeSettings(paths) {
+  const settingsPath = path.join(paths.claude.userData, "settings.json");
+  let settings = {};
+  if (fs.existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    } catch {
+      throw new Error(`Claude Code settings are not valid JSON: ${settingsPath}`);
+    }
+  }
+  if (!settings || typeof settings !== "object" || Array.isArray(settings)) {
+    throw new Error(`Claude Code settings must contain a JSON object: ${settingsPath}`);
+  }
+  applyImpelClaudeSandbox(settings);
+  writeAtomic(settingsPath, `${JSON.stringify(settings, null, 2)}\n`, 0o600);
+}
+
 function writeClaudeDefaultApp(paths) {
   const configPath = path.join(paths.claude.userData, "claude_desktop_config.json");
   let current = {};
@@ -876,14 +944,29 @@ function writeClaudeDefaultApp(paths) {
   if (!preferences || typeof preferences !== "object" || Array.isArray(preferences)) {
     throw new Error(`Claude desktop preferences must contain a JSON object: ${configPath}`);
   }
+  // The desktop app gates its UI on a persisted top-level `deploymentMode`:
+  // until it is "3p", every launch lands on the sign-in / provider-chooser
+  // screen — even though the applied configLibrary gateway config loads fine —
+  // and Claude.ai email login is server-disabled for 3P profiles
+  // (custom_3p_not_available). A managed gateway profile is only ever 3P, so
+  // enforce the key like the sandbox policy (heal "1p"/cleared values too,
+  // e.g. after an in-app sign-out), not seed-once like a user preference.
+  const needsDeploymentMode = current.deploymentMode !== "3p";
   // Claude persists the selected top-level app as `preferences.sidebarMode`.
   // Seed Code for a new isolated profile, then leave subsequent user choices
   // alone during install, update, and background config refreshes.
-  if (Object.hasOwn(preferences, "sidebarMode")) return;
-  writeAtomic(configPath, JSON.stringify({
+  const needsSidebarMode = !Object.hasOwn(preferences, "sidebarMode");
+  if (!needsDeploymentMode && !needsSidebarMode) return;
+  const next = {
     ...current,
-    preferences: { ...preferences, sidebarMode: "code" },
-  }, null, 2) + "\n", 0o600);
+    ...(needsDeploymentMode ? { deploymentMode: "3p" } : {}),
+    preferences: needsSidebarMode ? { ...preferences, sidebarMode: "code" } : preferences,
+  };
+  // A vendor sign-out writes `awaitingSignIn: true` alongside "1p". Left in
+  // place it re-arms the app's quit-time revert — which deletes deploymentMode
+  // again — should the gateway config ever fail to load. Drop it when healing.
+  if (needsDeploymentMode) delete next.awaitingSignIn;
+  writeAtomic(configPath, JSON.stringify(next, null, 2) + "\n", 0o600);
 }
 
 function writeChatGPTConfig(paths, config, models, vendorCodexModels, invocations = null) {
@@ -1367,16 +1450,28 @@ function writeVendoredChatGPTBundle(paths, vendorPath, gatewayUrl) {
     const runtimeAsarPath = path.join(staging, "Contents", "Resources", "app.asar");
     const fastModePatchCount = patchFastModeAuthGate(runtimeAsarPath);
     const asarHash = asarHeaderHash(runtimeAsarPath);
+    const launchHost = ensureChatGPTLaunchHost();
     writeAtomic(
       path.join(staging, "Contents", "Info.plist"),
-      vendoredChatGPTWrapperPlist(vendorPath, asarHash, paths.chatgpt),
+      vendoredChatGPTWrapperPlist(vendorPath, asarHash, paths.chatgpt, launchHost ? "launch-host" : "launch"),
       0o644,
     );
+    // With the Mach-O launch host as the bundle executable, the launch script
+    // lives in Resources (codesign seals it as a resource; anything else in
+    // Contents/MacOS would need its own code signature). Its $HERE/../Resources
+    // references resolve identically from either directory. Without a compiler
+    // the script stays in MacOS as the executable (pre-Tahoe layout).
     writeAtomic(
-      path.join(macos, "launch"),
+      path.join(launchHost ? path.join(staging, "Contents", "Resources") : macos, "launch"),
       vendoredChatGPTLauncher(paths, vendorBundleName, executableName, gatewayUrl),
       0o755,
     );
+    if (launchHost) {
+      fs.mkdirSync(macos, { recursive: true });
+      const hostTarget = path.join(macos, "launch-host");
+      fs.copyFileSync(launchHost, hostTarget);
+      fs.chmodSync(hostTarget, 0o755);
+    }
     writeAtomic(
       path.join(staging, "Contents", "Resources", "impel-chatgpt-preload.cjs"),
       vendoredChatGPTDisplayNamePreload(),
@@ -1760,12 +1855,101 @@ function rebrandElectronHelpers(bundle, { fromName, toName, fromIdentifier, toId
   }
 }
 
-function vendoredChatGPTWrapperPlist(vendorPath, asarHash, identity) {
+// macOS 26 (Tahoe) Launch Services refuses to launch a bundle whose
+// CFBundleExecutable is a script (_LSOpenURLsWithCompletionHandler error
+// -10669), so the wrapper's main executable must be a real Mach-O. This tiny
+// host binary exec()s the launch script in Contents/Resources, preserving the
+// script-based setup flow and the bundle's designated requirement.
+const CHATGPT_LAUNCH_HOST_SOURCE = `#include <libgen.h>
+#include <limits.h>
+#include <mach-o/dyld.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+int main(int argc, char *argv[]) {
+  char exe[PATH_MAX];
+  uint32_t size = sizeof(exe);
+  if (_NSGetExecutablePath(exe, &size) != 0) return 1;
+  char resolved[PATH_MAX];
+  if (!realpath(exe, resolved)) return 1;
+  char script[PATH_MAX];
+  if (snprintf(script, sizeof(script), "%s/../Resources/launch", dirname(resolved)) >= (int)sizeof(script)) return 1;
+  char **args = calloc((size_t)argc + 1, sizeof(char *));
+  if (!args) return 1;
+  args[0] = script;
+  for (int i = 1; i < argc; i++) args[i] = argv[i];
+  args[argc] = NULL;
+  execv(script, args);
+  perror("execv");
+  return 1;
+}
+`;
+
+/**
+ * Compile (once) and cache the Mach-O launch host for the ChatGPT wrapper.
+ * Returns the cached binary's path, or null when it cannot be built (no
+ * compiler); callers then fall back to the script-only layout. That fallback
+ * still launches on macOS ≤ 15, but macOS 26 refuses it (-10669), so the
+ * failure is reported loudly there instead of silently installing an app
+ * that will never open.
+ */
+export function ensureChatGPTLaunchHost({
+  platform = process.platform,
+  osRelease = os.release(),
+  compiler = "/usr/bin/cc",
+  cacheDir = fileURLToPath(new URL("../cache", import.meta.url)),
+  warn = console.warn,
+} = {}) {
+  if (platform !== "darwin") return null;
+  const sourceHash = crypto.createHash("sha256").update(CHATGPT_LAUNCH_HOST_SOURCE).digest("hex").slice(0, 12);
+  const hostPath = path.join(cacheDir, `launch-host-${sourceHash}`);
+  const failed = (detail) => {
+    // Darwin 25 == macOS 26, the first release that refuses script-executable
+    // bundles; earlier releases launch the fallback layout fine, so stay quiet.
+    if (Number.parseInt(osRelease, 10) >= 25) {
+      warn(
+        `impel: could not compile the Impel ChatGPT launch helper (${redactSecretText(String(detail || "unknown error"))}); `
+        + "macOS 26 refuses to open the script-based fallback app. Install the Xcode Command Line Tools "
+        + "(xcode-select --install), then run `impel app update chatgpt`.",
+      );
+    }
+    return null;
+  };
+  const building = path.join(cacheDir, `.launch-host-${sourceHash}.tmp-${process.pid}`);
+  try {
+    if (fs.existsSync(hostPath) && isMachO(hostPath)) return hostPath;
+    fs.mkdirSync(cacheDir, { recursive: true, mode: 0o700 });
+    const source = path.join(os.tmpdir(), `impel-launch-host-${process.pid}.c`);
+    fs.writeFileSync(source, CHATGPT_LAUNCH_HOST_SOURCE, { mode: 0o600 });
+    // Compile to a process-private path and rename into place: concurrent
+    // installs share this cache, and a reader must never see a partial binary.
+    const built = spawnSync(compiler, ["-O2", "-o", building, source], { encoding: "utf8" });
+    fs.rmSync(source, { force: true });
+    if (built.error || built.status !== 0 || !fs.existsSync(building) || !isMachO(building)) {
+      fs.rmSync(building, { force: true });
+      const detail = built.error?.message
+        || String(built.stderr || "").trim().split("\n")[0]
+        || `compiler exit code ${built.status}`;
+      return failed(detail);
+    }
+    fs.chmodSync(building, 0o755);
+    fs.renameSync(building, hostPath);
+    return hostPath;
+  } catch (error) {
+    fs.rmSync(building, { force: true });
+    return failed(error?.message);
+  }
+}
+
+function vendoredChatGPTWrapperPlist(vendorPath, asarHash, identity, executableName = "launch") {
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0"><dict>
 <key>CFBundleDisplayName</key><string>${xmlEscape(identity.displayName)}</string>
-<key>CFBundleExecutable</key><string>launch</string>
+<key>CFBundleExecutable</key><string>${xmlEscape(executableName)}</string>
 <key>CFBundleIconFile</key><string>electron.icns</string>
 <key>CFBundleIdentifier</key><string>${xmlEscape(identity.bundleIdentifier)}</string>
 <key>CFBundleName</key><string>${xmlEscape(identity.displayName)}</string>

package/src/claudeSandbox.js

@@ -0,0 +1,80 @@
+const MANAGED_SANDBOX_KEYS = Object.freeze([
+  "enabled",
+  "failIfUnavailable",
+  "autoAllowBashIfSandboxed",
+  "allowUnsandboxedCommands",
+  "excludedCommands",
+]);
+
+function isJsonObject(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+
+function sameJsonValue(left, right) {
+  return JSON.stringify(left) === JSON.stringify(right);
+}
+
+/**
+ * Claude Code's strict, auto-allow sandbox profile.
+ *
+ * Native Windows does not implement Claude's sandbox. Keep it enabled so the
+ * same profile becomes effective in WSL, but do not make native Windows fail
+ * at startup solely because the platform cannot initialize it.
+ */
+export function impelClaudeSandboxPolicy(platform = process.platform) {
+  return {
+    enabled: true,
+    failIfUnavailable: platform !== "win32",
+    autoAllowBashIfSandboxed: true,
+    allowUnsandboxedCommands: false,
+    excludedCommands: [],
+  };
+}
+
+/** Apply the managed sandbox keys while preserving unrelated sandbox config. */
+export function applyImpelClaudeSandbox(settings, platform = process.platform) {
+  const current = isJsonObject(settings.sandbox) ? settings.sandbox : {};
+  settings.sandbox = {
+    ...current,
+    ...impelClaudeSandboxPolicy(platform),
+  };
+  return settings.sandbox;
+}
+
+/** Capture the exact pre-Impel value for reversible native-profile switching. */
+export function captureClaudeSandbox(settings) {
+  return Object.hasOwn(settings, "sandbox")
+    ? { present: true, value: settings.sandbox }
+    : { present: false };
+}
+
+/**
+ * Restore only managed keys that still hold Impel's values. User changes made
+ * while gateway mode was active, plus unrelated filesystem/network keys, win.
+ */
+export function restoreClaudeSandbox(settings, snapshot, platform = process.platform) {
+  if (!isJsonObject(settings.sandbox)) return false;
+  const policy = impelClaudeSandboxPolicy(platform);
+  const prior = snapshot?.present === true && isJsonObject(snapshot.value)
+    ? snapshot.value
+    : null;
+  const sandbox = { ...settings.sandbox };
+  let changed = false;
+
+  for (const key of MANAGED_SANDBOX_KEYS) {
+    if (!Object.hasOwn(sandbox, key) || !sameJsonValue(sandbox[key], policy[key])) continue;
+    if (prior && Object.hasOwn(prior, key)) sandbox[key] = prior[key];
+    else delete sandbox[key];
+    changed = true;
+  }
+
+  if (!changed) return false;
+  if (Object.keys(sandbox).length > 0 || (snapshot?.present === true && prior)) {
+    settings.sandbox = sandbox;
+  } else if (snapshot?.present === true) {
+    settings.sandbox = snapshot.value;
+  } else {
+    delete settings.sandbox;
+  }
+  return true;
+}

package/src/claudeSetup.js

@@ -10,6 +10,11 @@ import os from "node:os";
 import path from "node:path";
 
 import { IMPEL_MANAGED_MCP_ENV, impelMcpInvocation } from "./selfInvocation.js";
+import {
+  applyImpelClaudeSandbox,
+  captureClaudeSandbox,
+  restoreClaudeSandbox,
+} from "./claudeSandbox.js";
 
 export const CLAUDE_DIR = path.join(os.homedir(), ".claude");
 export const CLAUDE_SETTINGS_PATH = path.join(CLAUDE_DIR, "settings.json");
@@ -123,12 +128,14 @@ export function applyClaudeGateway(gatewayUrl) {
 
   const priorApiKeyHelper = settings.apiKeyHelper;
   const priorBaseUrl = settings.env?.ANTHROPIC_BASE_URL;
+  const priorSandbox = captureClaudeSandbox(settings);
 
   settings.apiKeyHelper = IMPEL_API_KEY_HELPER;
   settings.env = {
     ...(settings.env || {}),
     ANTHROPIC_BASE_URL: impelClaudeBaseUrl(gatewayUrl),
   };
+  const sandbox = applyImpelClaudeSandbox(settings);
 
   writeSettings(settings);
   userConfig.mcpServers = {
@@ -143,6 +150,8 @@ export function applyClaudeGateway(gatewayUrl) {
     baseUrl: settings.env.ANTHROPIC_BASE_URL,
     priorApiKeyHelper,
     priorBaseUrl,
+    priorSandbox,
+    sandbox,
   };
 }
 
@@ -179,6 +188,9 @@ export function revertClaudeGateway(gatewayUrl, backup = {}) {
     changed = true;
   }
 
+  const restoredSandbox = restoreClaudeSandbox(settings, backup.sandbox);
+  if (restoredSandbox) changed = true;
+
   if (changed) writeSettings(settings);
 
   if (isImpelMcpServer(userConfig.mcpServers?.[IMPEL_MCP_SERVER_NAME])) {
@@ -201,6 +213,7 @@ export function revertClaudeGateway(gatewayUrl, backup = {}) {
     removedHelper,
     removedBaseUrl,
     removedMcpServer,
+    restoredSandbox,
     restoredApiKeyHelper: removedHelper && backup.apiKeyHelper != null ? backup.apiKeyHelper : null,
     restoredBaseUrl: removedBaseUrl && backup.ANTHROPIC_BASE_URL != null ? backup.ANTHROPIC_BASE_URL : null,
   };

package/src/cliProfiles.js

@@ -11,6 +11,7 @@ import {
 import { CONFIG_DIR } from "./config.js";
 import { normalizeTenantId } from "./tenants.js";
 import { impelCliInvocation, impelMcpInvocation } from "./selfInvocation.js";
+import { applyImpelClaudeSandbox } from "./claudeSandbox.js";
 
 export const IMPEL_CLI_PROFILES_DIR = path.join(CONFIG_DIR, "cli");
 
@@ -118,6 +119,7 @@ export function ensureImpelClaudeProfile(gatewayUrl, tenantId, { crossAppModels
     delete managedEnvironment.CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY;
   }
   settings.env = managedEnvironment;
+  applyImpelClaudeSandbox(settings);
   userConfig.mcpServers = {
     ...(userConfig.mcpServers &&
     typeof userConfig.mcpServers === "object" &&

package/src/commands/apps.js

@@ -986,13 +986,14 @@ async function refreshApps(targets, { staleOnly = false, tenantId = null } = {})
   }
 }
 
-function manifestIsFresh(paths, config, now = Date.now()) {
+export function manifestIsFresh(paths, config, now = Date.now()) {
   try {
     const manifest = JSON.parse(
       fs.readFileSync(path.join(paths.tenantRoot, "manifest.json"), "utf8")
     );
     const updatedAt = Date.parse(manifest?.updatedAt || "");
     return Number.isFinite(updatedAt)
+      && manifest?.configVersion === CURRENT_CONFIG_VERSION
       && manifest?.experiments?.crossAppModels === crossAppModelsEnabled(config)
       && now - updatedAt < REFRESH_TTL_MS;
   } catch {

package/src/commands/use.js

@@ -76,9 +76,13 @@ async function useGateway({ target, app }) {
     if (!isImpelClaudeBaseUrl(result.priorBaseUrl, gatewayUrl)) {
       backup.ANTHROPIC_BASE_URL = result.priorBaseUrl ?? null;
     }
+    if (!Object.hasOwn(backup, "sandbox")) {
+      backup.sandbox = result.priorSandbox;
+    }
     console.log(`Claude Code -> GATEWAY  (${result.path})`);
     console.log(`  apiKeyHelper = "${result.apiKeyHelper}"`);
     console.log(`  env.ANTHROPIC_BASE_URL = "${result.baseUrl}"`);
+    console.log(`  sandbox = strict auto-allow (${result.sandbox.failIfUnavailable ? "fail closed" : "platform fallback"})`);
     console.log(`  MCP server = "impel" (direct Impel CLI invocation)`);
   }
 
@@ -167,6 +171,9 @@ function useAccount({ target, app }) {
       if (result.removedMcpServer) {
         console.log(`  removed Impel MCP server`);
       }
+      if (result.restoredSandbox) {
+        console.log(`  restored prior Claude sandbox settings`);
+      }
     }
     if (config?.backups) delete config.backups.claude;
   }

package/src/gateway/index.js

@@ -5,6 +5,7 @@ import path from "node:path";
 import readline from "node:readline";
 
 import { nativeCommandInvocation } from "../nativeProcess.js";
+import { applyImpelClaudeSandbox } from "../claudeSandbox.js";
 
 const SAFE_ID = /^[a-z][a-z0-9-]{2,31}$/u;
 const SAFE_NAMESPACE = /^[a-z][a-z0-9_-]{1,31}$/u;
@@ -301,6 +302,7 @@ export function createGatewayCli(options) {
     };
     delete settings.env.ANTHROPIC_API_KEY;
     delete settings.env.ANTHROPIC_AUTH_TOKEN;
+    applyImpelClaudeSandbox(settings);
     writePrivateFile(settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
     return { configDir, settingsPath };
   }