Function detectWindowsCodexSetup

core/codex/native-integrations.js:499–540

(options = {})

    prompt: 'Use projected .codex/agents for specialized subagents. Preserve Citadel .planning state and discovery relay across waves.',
    createdAt: nowIso(options),
  };
  if (options.write) {
    writeJson(path.join(planningDir(projectRoot, 'fleet'), 'codex-native-plan.json'), plan);
  }
  return plan;
}

function detectWindowsCodexSetup(options = {}) {
  const projectRoot = path.resolve(options.projectRoot || process.cwd());
  const platform = options.platform || process.platform;
  const env = options.env || process.env;
  const configPath = options.configPath || path.join(projectRoot, '.codex', 'config.toml');
  const config = readTextIfExists(configPath);
  const isWindows = platform === 'win32';
  const isWsl = Boolean(env.WSL_DISTRO_NAME || env.WSL_INTEROP);
  const sandboxMatch = config.match(/^\s*sandbox\s*=\s*"(elevated|unelevated)"/m);
  const hasNativeSandboxMode = Boolean(sandboxMatch);
  const shellLooksWindowsSafe = /agent_shell\s*=\s*"git-bash"/.test(config) || /powershell|pwsh|bash/i.test(config);

  const checks = [
    {
      id: 'platform',
      pass: isWindows || isWsl,
      detail: isWindows ? 'native Windows' : (isWsl ? 'WSL2-like environment' : platform),
    },
    {
      id: 'windows-sandbox',
      pass: !isWindows || hasNativeSandboxMode,
      detail: sandboxMatch ? sandboxMatch[1] : 'missing [windows] sandbox = "elevated" or "unelevated"',
    },
    {
      id: 'shell',
      pass: !isWindows || shellLooksWindowsSafe,
      detail: shellLooksWindowsSafe ? 'Codex shell configuration found' : 'no Windows-safe shell hint found',
    },
  ];

  return {
    projectRoot,
    isWindows,
    isWsl,
    configPath,
    checks,
    pass: checks.every((check) => check.pass),
    recommendation: isWindows