zcf 3.3.3 → 3.4.0

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { aa as ensureI18nInitialized, ab as i18n, aC as readCcrConfig, ax as isCcrInstalled, ay as installCcr, aD as configureCcrFeature, aE as handleExitPromptError, aF as handleGeneralError, aG as COMETIX_COMMAND_NAME, aH as COMETIX_COMMANDS, aI as installCometixLine, ac as addNumbersToChoices, aJ as checkAndUpdateTools, aK as runCodexUpdate, aL as resolveCodeType$1, ai as readJsonConfig, aM as writeJsonConfig, q as ZCF_CONFIG_FILE, aN as displayBanner, as as readZcfConfig, aq as updateZcfConfig, aO as version, aP as resolveAiOutputLanguage, aQ as updatePromptOnly, aR as selectAndInstallWorkflows, aS as checkClaudeCodeVersionAndPrompt, w as resolveCodeToolType$1, D as DEFAULT_CODE_TOOL_TYPE, u as isCodeToolType, aT as displayBannerWithInfo, s as CODE_TOOL_BANNERS, aU as runCodexUninstall, aV as configureCodexMcp, aW as configureCodexApi, aX as runCodexWorkflowImportWithLanguageSelection, aY as runCodexFullInit, i as init, aZ as switchCodexProvider, a_ as listCodexProviders, am as readCodexConfig, a$ as switchToOfficialLogin, b0 as switchToProvider, b1 as readZcfConfigAsync, b2 as initI18n, b3 as selectScriptLanguage, ar as changeLanguage } from './chunks/simple-config.mjs';
+import { ah as ensureI18nInitialized, ai as i18n, aK as readCcrConfig, aF as isCcrInstalled, aG as installCcr, aL as configureCcrFeature, al as promptBoolean, aM as handleExitPromptError, aN as handleGeneralError, aO as COMETIX_COMMAND_NAME, aP as COMETIX_COMMANDS, aQ as installCometixLine, aj as addNumbersToChoices, aR as checkAndUpdateTools, aS as runCodexUpdate, aT as resolveCodeType$1, aq as readJsonConfig, aU as writeJsonConfig, q as ZCF_CONFIG_FILE, aA as readZcfConfig, D as DEFAULT_CODE_TOOL_TYPE, u as isCodeToolType, aV as displayBanner, ay as updateZcfConfig, aW as version, aX as resolveAiOutputLanguage, aY as updatePromptOnly, aZ as selectAndInstallWorkflows, a_ as checkClaudeCodeVersionAndPrompt, w as resolveCodeToolType$1, a$ as displayBannerWithInfo, s as CODE_TOOL_BANNERS, b0 as runCodexUninstall, b1 as configureCodexMcp, b2 as configureCodexApi, b3 as runCodexWorkflowImportWithLanguageSelection, b4 as runCodexFullInit, i as init, b5 as switchCodexProvider, b6 as listCodexProviders, au as readCodexConfig, b7 as switchToOfficialLogin, b8 as switchToProvider, b9 as readZcfConfigAsync, ba as initI18n, bb as selectScriptLanguage, az as changeLanguage } from './chunks/simple-config.mjs';
 import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import inquirer from 'inquirer';
@@ -17,6 +17,7 @@ import { m as moveToTrash } from './shared/zcf.DGjQxTq_.mjs';
 import { ClaudeCodeConfigManager } from './chunks/claude-code-config-manager.mjs';
 import 'dayjs';
 import 'node:url';
+import 'inquirer-toggle';
 import 'ora';
 import 'semver';
 import 'smol-toml';
@@ -129,11 +130,9 @@ ${ansis.cyan("\u2550".repeat(50))}`);
       console.log(`
 ${ansis.dim("\u2500".repeat(50))}
 `);
-      const { continueInCcr } = await inquirer.prompt({
-        type: "confirm",
-        name: "continueInCcr",
+      const continueInCcr = await promptBoolean({
         message: i18n.t("common:returnToMenu"),
-        default: true
+        defaultValue: true
       });
       if (continueInCcr) {
         return await showCcrMenu();
@@ -258,11 +257,9 @@ ${ansis.cyan("\u2550".repeat(50))}`);
       console.log(`
 ${ansis.dim("\u2500".repeat(50))}
 `);
-      const { continueInCometix } = await inquirer.prompt({
-        type: "confirm",
-        name: "continueInCometix",
+      const continueInCometix = await promptBoolean({
         message: i18n.t("common:returnToMenu"),
-        default: true
+        defaultValue: true
       });
       if (continueInCometix) {
         return await showCometixMenu();
@@ -690,19 +687,24 @@ class ZcfUninstaller {
         result.removed.push(".claude.json (includes MCP configuration)");
       }
       try {
-        await exec$1("npm", ["uninstall", "-g", "@anthropic-ai/claude-code"]);
-        result.removed.push("@anthropic-ai/claude-code package");
-        result.success = true;
+        const { uninstallCodeTool } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bk; });
+        const success = await uninstallCodeTool("claude-code");
+        if (success) {
+          result.removed.push("@anthropic-ai/claude-code");
+          result.success = true;
+        } else {
+          result.errors.push(i18n.t("uninstall:uninstallFailed", { codeType: i18n.t("common:claudeCode"), message: "" }));
+        }
       } catch (npmError) {
         if (npmError.message.includes("not found") || npmError.message.includes("not installed")) {
           result.warnings.push(i18n.t("uninstall:claudeCodePackageNotFound"));
           result.success = true;
         } else {
-          result.errors.push(`Failed to uninstall Claude Code package: ${npmError.message}`);
+          result.errors.push(i18n.t("uninstall:uninstallFailed", { codeType: i18n.t("common:claudeCode"), message: `: ${npmError.message}` }));
         }
       }
     } catch (error) {
-      result.errors.push(`Failed to uninstall Claude Code: ${error.message}`);
+      result.errors.push(i18n.t("uninstall:uninstallFailed", { codeType: i18n.t("common:claudeCode"), message: `: ${error.message}` }));
     }
     return result;
   }
@@ -905,7 +907,26 @@ class ZcfUninstaller {
 async function uninstall(options = {}) {
   try {
     ensureI18nInitialized();
+    let codeType;
+    if (options.codeType) {
+      try {
+        codeType = await resolveCodeType$1(options.codeType);
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(ansis.red(`${i18n.t("errors:generalError")} ${errorMessage}`));
+        const config = readZcfConfig();
+        codeType = config?.codeToolType && isCodeToolType(config.codeToolType) ? config.codeToolType : DEFAULT_CODE_TOOL_TYPE;
+      }
+    } else {
+      const config = readZcfConfig();
+      codeType = config?.codeToolType && isCodeToolType(config.codeToolType) ? config.codeToolType : DEFAULT_CODE_TOOL_TYPE;
+    }
     const uninstaller = new ZcfUninstaller(options.lang || "en");
+    if (codeType === "codex") {
+      const { runCodexUninstall } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bj; });
+      await runCodexUninstall();
+      return;
+    }
     if (options.mode && options.mode !== "interactive") {
       if (options.mode === "complete") {
         await executeCompleteUninstall(uninstaller);
@@ -930,7 +951,6 @@ async function uninstall(options = {}) {
 }
 async function showInteractiveUninstall(uninstaller) {
   console.log(ansis.cyan.bold(i18n.t("uninstall:title")));
-  console.log(ansis.yellow(i18n.t("uninstall:warning")));
   console.log("");
   const { mainChoice } = await inquirer.prompt({
     type: "list",
@@ -1029,11 +1049,9 @@ async function executeCompleteUninstall(uninstaller) {
   console.log("");
   console.log(ansis.red.bold(i18n.t("uninstall:executingComplete")));
   console.log(ansis.yellow(i18n.t("uninstall:completeWarning")));
-  const { confirm } = await inquirer.prompt({
-    type: "confirm",
-    name: "confirm",
+  const confirm = await promptBoolean({
     message: i18n.t("uninstall:confirmComplete"),
-    default: false
+    defaultValue: false
   });
   if (!confirm) {
     console.log(ansis.yellow(i18n.t("common:cancelled")));
@@ -1051,11 +1069,9 @@ async function executeCustomUninstall(uninstaller, items) {
   items.forEach((item) => {
     console.log(`  \u2022 ${i18n.t(`uninstall:${item}`)}`);
   });
-  const { confirm } = await inquirer.prompt({
-    type: "confirm",
-    name: "confirm",
+  const confirm = await promptBoolean({
     message: i18n.t("uninstall:confirmCustom"),
-    default: false
+    defaultValue: false
   });
   if (!confirm) {
     console.log(ansis.yellow(i18n.t("common:cancelled")));
@@ -1177,7 +1193,7 @@ async function update(options = {}) {
       }
       return;
     }
-    const { resolveTemplateLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.ba; });
+    const { resolveTemplateLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bi; });
     const configLang = await resolveTemplateLanguage(
       options.configLang,
       // Command line option
@@ -1392,11 +1408,9 @@ async function showClaudeCodeMenu() {
       return void 0;
   }
   printSeparator();
-  const { continue: shouldContinue } = await inquirer.prompt({
-    type: "confirm",
-    name: "continue",
+  const shouldContinue = await promptBoolean({
     message: i18n.t("common:returnToMenu"),
-    default: true
+    defaultValue: true
   });
   if (!shouldContinue) {
     console.log(ansis.cyan(i18n.t("common:goodbye")));
@@ -1494,11 +1508,9 @@ async function showCodexMenu() {
       return void 0;
   }
   printSeparator();
-  const { continue: shouldContinue } = await inquirer.prompt({
-    type: "confirm",
-    name: "continue",
+  const shouldContinue = await promptBoolean({
     message: i18n.t("common:returnToMenu"),
-    default: true
+    defaultValue: true
   });
   if (!shouldContinue) {
     console.log(ansis.cyan(i18n.t("common:goodbye")));
@@ -1979,10 +1991,10 @@ async function setupCommands(cli) {
       list: options.list
     });
   }));
-  cli.command("uninstall", "Remove ZCF configurations and tools").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--mode, -m <mode>", "Uninstall mode (complete/custom/interactive), default: interactive").option("--items, -i <items>", "Comma-separated items for custom uninstall mode").action(await withLanguageResolution(async (options) => {
+  cli.command("uninstall", "Remove ZCF configurations and tools").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").option("--mode, -m <mode>", "Uninstall mode (complete/custom/interactive), default: interactive").option("--items, -i <items>", "Comma-separated items for custom uninstall mode").action(await withLanguageResolution(async (options) => {
     await uninstall(options);
   }));
-  cli.command("check-updates", "Check and update Claude Code and CCR to latest versions").alias("check").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").action(await withLanguageResolution(async (options) => {
+  cli.command("check-updates", "Check and update Claude Code and CCR to latest versions").alias("check").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").option("--skip-prompt, -s", "Skip all interactive prompts (non-interactive mode)").action(await withLanguageResolution(async (options) => {
     await checkUpdates(options);
   }));
   cli.help((sections) => customizeHelp(sections));

package/dist/i18n/locales/en/codex.json

@@ -1,6 +1,4 @@
 {
-  "installingCli": "🚀 Installing Codex CLI...",
-  "installSuccess": "✔ Codex CLI installed",
   "usingSudo": "⚠️ Detected non-root Linux user. Using sudo for Codex CLI installation (password prompt may appear).",
   "alreadyInstalled": "⚠️ Codex CLI already installed, skipping installation",
   "updatingCli": "🔄 Updating Codex CLI...",
@@ -105,5 +103,17 @@
   "upToDate": "Codex is up to date (v{version})",
   "notInstalled": "Codex is not installed",
   "cannotCheckVersion": "Cannot check latest version",
-  "checkFailed": "Version check failed"
+  "checkFailed": "Version check failed",
+  "providerManager.noConfig": "No existing configuration found",
+  "providerManager.backupFailed": "Failed to create backup",
+  "providerManager.providerExists": "Provider with ID \"{{id}}\" already exists",
+  "providerManager.providerNotFound": "Provider with ID \"{{id}}\" not found",
+  "providerManager.noProvidersSpecified": "No providers specified for deletion",
+  "providerManager.providersNotFound": "Some providers not found: {{providers}}",
+  "providerManager.cannotDeleteAll": "Cannot delete all providers. At least one provider must remain.",
+  "providerManager.providerIdRequired": "Provider ID is required",
+  "providerManager.providerNameRequired": "Provider name is required",
+  "providerManager.baseUrlRequired": "Base URL is required",
+  "providerManager.wireApiInvalid": "Wire API must be either \"responses\" or \"chat\"",
+  "providerManager.unknownError": "Unknown error"
 }

package/dist/i18n/locales/en/common.json

@@ -13,5 +13,7 @@
   "back": "Back",
   "operationFailed": "Operation failed",
   "backupCreated": "📁 Configuration backup created: {{path}}",
-  "current": "current"
+  "current": "current",
+  "claudeCode": "Claude Code",
+  "codex": "Codex"
 }

package/dist/i18n/locales/en/installation.json

@@ -29,5 +29,19 @@
   "wslDetected": "WSL environment detected ({distro})",
   "wslDetectedGeneric": "WSL environment detected",
   "wslPathInfo": "Configuration path: {path}",
-  "wslInstallSuccess": "Claude Code successfully installed in WSL environment"
+  "wslInstallSuccess": "Claude Code successfully installed in WSL environment",
+  "selectInstallMethod": "Please select installation method for {{codeType}}:",
+  "recommendedMethod": "Recommended",
+  "installingWith": "Installing {{codeType}} using {{method}}...",
+  "installMethodSuccess": "Successfully installed using {{method}}",
+  "installMethodFailed": "Failed to install using {{method}}",
+  "tryAnotherMethod": "Installation failed. Try another method?",
+  "noMoreMethods": "No more installation methods available",
+  "detectedVersion": "Detected version {{version}}",
+  "uninstallingWith": "Uninstalling {{codeType}} using {{method}}...",
+  "uninstallSuccess": "Successfully uninstalled using {{method}}",
+  "uninstallFailed": "Failed to uninstall using {{method}}",
+  "manualUninstallRequired": "{{codeType}} requires manual uninstallation",
+  "binaryLocation": "Binary location: {{path}}",
+  "failedToLocateBinary": "Failed to locate {{command}} binary"
 }

package/dist/i18n/locales/en/uninstall.json

@@ -1,6 +1,5 @@
 {
   "title": "ZCF Uninstaller",
-  "warning": "⚠️  This will permanently remove Claude Code configurations and tools from your system.",
   "selectMainOption": "Select uninstall option:",
   "completeUninstall": "Complete Uninstall",
   "completeUninstallDesc": "Remove all Claude Code related configurations and tools",
@@ -52,5 +51,6 @@
   "claudeCodePackageNotFound": "Claude Code package not found",
   "backupsNotFound": "Backup directory not found",
   "zcfConfigNotFound": "ZCF configuration file not found",
-  "outputStylesDirectoryNotFound": "Output styles directory not found"
+  "outputStylesDirectoryNotFound": "Output styles directory not found",
+  "uninstallFailed": "Failed to uninstall {{codeType}}{{message}}"
 }

package/dist/i18n/locales/zh-CN/codex.json

@@ -1,6 +1,4 @@
 {
-  "installingCli": "🚀 正在安装 Codex CLI...",
-  "installSuccess": "✔ Codex CLI 安装完成",
   "usingSudo": "⚠️ 检测到 Linux 非 root 用户，正在使用 sudo 安装 Codex CLI（可能需要输入密码）。",
   "alreadyInstalled": "⚠️ Codex CLI 已安装，跳过安装步骤",
   "updatingCli": "🔄 正在更新 Codex CLI...",
@@ -105,5 +103,17 @@
   "upToDate": "Codex 已是最新版本 (v{version})",
   "notInstalled": "Codex 未安装",
   "cannotCheckVersion": "无法检查最新版本",
-  "checkFailed": "版本检查失败"
+  "checkFailed": "版本检查失败",
+  "providerManager.noConfig": "未找到现有配置",
+  "providerManager.backupFailed": "创建备份失败",
+  "providerManager.providerExists": "ID 为 \"{{id}}\" 的提供商已存在",
+  "providerManager.providerNotFound": "ID 为 \"{{id}}\" 的提供商不存在",
+  "providerManager.noProvidersSpecified": "未指定要删除的提供商",
+  "providerManager.providersNotFound": "未找到以下提供商：{{providers}}",
+  "providerManager.cannotDeleteAll": "不能删除所有提供商，至少需要保留一个",
+  "providerManager.providerIdRequired": "提供商 ID 是必需的",
+  "providerManager.providerNameRequired": "提供商名称是必需的",
+  "providerManager.baseUrlRequired": "基础 URL 是必需的",
+  "providerManager.wireApiInvalid": "Wire API 必须是 \"responses\" 或 \"chat\"",
+  "providerManager.unknownError": "未知错误"
 }

package/dist/i18n/locales/zh-CN/common.json

@@ -13,5 +13,7 @@
   "back": "返回",
   "operationFailed": "操作失败",
   "backupCreated": "📁 已创建配置备份：{{path}}",
-  "current": "当前"
+  "current": "当前",
+  "claudeCode": "Claude Code",
+  "codex": "Codex"
 }

package/dist/i18n/locales/zh-CN/installation.json

@@ -29,5 +29,19 @@
   "wslDetected": "检测到 WSL 环境 ({distro})",
   "wslDetectedGeneric": "检测到 WSL 环境",
   "wslPathInfo": "配置文件位置：{path}",
-  "wslInstallSuccess": "Claude Code 已成功安装在 WSL 环境中"
+  "wslInstallSuccess": "Claude Code 已成功安装在 WSL 环境中",
+  "selectInstallMethod": "请选择 {{codeType}} 的安装方式：",
+  "recommendedMethod": "推荐",
+  "installingWith": "正在使用 {{method}} 安装 {{codeType}}...",
+  "installMethodSuccess": "使用 {{method}} 安装成功",
+  "installMethodFailed": "使用 {{method}} 安装失败",
+  "tryAnotherMethod": "安装失败，是否尝试其他安装方式？",
+  "noMoreMethods": "没有更多可用的安装方式",
+  "detectedVersion": "检测到版本 {{version}}",
+  "uninstallingWith": "正在使用 {{method}} 卸载 {{codeType}}...",
+  "uninstallSuccess": "使用 {{method}} 卸载成功",
+  "uninstallFailed": "使用 {{method}} 卸载失败",
+  "manualUninstallRequired": "{{codeType}} 需要手动卸载",
+  "binaryLocation": "可执行文件位置：{{path}}",
+  "failedToLocateBinary": "无法定位 {{command}} 可执行文件"
 }

package/dist/i18n/locales/zh-CN/uninstall.json

@@ -1,6 +1,5 @@
 {
   "title": "ZCF 卸载工具",
-  "warning": "⚠️  这将永久删除您系统中的 Claude Code 配置和工具。",
   "selectMainOption": "选择卸载选项:",
   "completeUninstall": "完全卸载",
   "completeUninstallDesc": "删除所有 Claude Code 相关配置和工具",
@@ -52,5 +51,6 @@
   "claudeCodePackageNotFound": "未找到 Claude Code 包",
   "backupsNotFound": "未找到备份目录",
   "zcfConfigNotFound": "未找到 ZCF 配置文件",
-  "outputStylesDirectoryNotFound": "未找到输出风格目录"
+  "outputStylesDirectoryNotFound": "未找到输出风格目录",
+  "uninstallFailed": "卸载 {{codeType}} 失败{{message}}"
 }

package/dist/index.d.mts

@@ -137,6 +137,10 @@ interface ApiConfig {
     key: string;
     authType?: 'auth_token' | 'api_key';
 }
+/**
+ * Installation method types for code tools
+ */
+type InstallMethod = 'npm' | 'homebrew' | 'curl' | 'powershell' | 'cmd';
 
 declare function ensureClaudeDir(): void;
 declare function backupExistingConfig(): string | null;
@@ -181,8 +185,29 @@ declare function switchToOfficialLogin(): boolean;
  */
 declare function promptApiConfigurationAction(): Promise<'modify-partial' | 'modify-all' | 'keep-existing' | null>;
 
+declare function getPlatform(): 'windows' | 'macos' | 'linux';
+declare function commandExists(command: string): Promise<boolean>;
+/**
+ * Get recommended install methods for a code tool based on current platform
+ * Returns methods in priority order (most recommended first)
+ */
+type CodeType = 'claude-code' | 'codex';
+
 declare function isClaudeCodeInstalled(): Promise<boolean>;
-declare function installClaudeCode(): Promise<void>;
+/**
+ * Install Claude Code with method selection support
+ * @param skipMethodSelection - If true, use default npm installation
+ */
+declare function installClaudeCode(skipMethodSelection?: boolean): Promise<void>;
+/**
+ * Check if Codex is installed
+ */
+declare function isCodexInstalled(): Promise<boolean>;
+/**
+ * Install Codex with method selection support
+ * @param skipMethodSelection - If true, use default npm installation
+ */
+declare function installCodex(skipMethodSelection?: boolean): Promise<void>;
 /**
  * Check if local Claude Code installation exists
  */
@@ -201,10 +226,33 @@ declare function getInstallationStatus(): Promise<InstallationStatus>;
  */
 declare function removeLocalClaudeCode(): Promise<void>;
 /**
- * Set installMethod to 'npm' in ~/.claude.json
+ * Uninstall code tool based on install method
+ * @param codeType - Type of code tool to uninstall
+ * @returns true if uninstalled successfully
+ */
+declare function uninstallCodeTool(codeType: CodeType): Promise<boolean>;
+/**
+ * Set installMethod in both ~/.claude.json and zcf-config
  * This ensures Claude Code knows it was installed via npm for proper auto-updates
  */
-declare function setInstallMethod(method?: 'npm' | 'native'): Promise<void>;
+declare function setInstallMethod(method?: InstallMethod | 'native', codeType?: CodeType): Promise<void>;
+/**
+ * Detect installed version of a code tool
+ * Returns version string or null if not installed
+ */
+declare function detectInstalledVersion(codeType: CodeType): Promise<string | null>;
+/**
+ * Select installation method interactively
+ */
+declare function selectInstallMethod(codeType: CodeType, excludeMethods?: InstallMethod[]): Promise<InstallMethod | null>;
+/**
+ * Execute installation using specified method
+ */
+declare function executeInstallMethod(method: InstallMethod, codeType: CodeType): Promise<boolean>;
+/**
+ * Handle installation failure with retry options
+ */
+declare function handleInstallFailure(codeType: CodeType, failedMethods: InstallMethod[]): Promise<boolean>;
 
 /**
  * Clean up and deduplicate permissions array
@@ -226,12 +274,9 @@ declare function cleanupPermissions(templatePermissions: string[], userPermissio
  */
 declare function mergeAndCleanPermissions(templatePermissions: string[] | undefined, userPermissions: string[] | undefined): string[];
 
-declare function getPlatform(): 'windows' | 'macos' | 'linux';
-declare function commandExists(command: string): Promise<boolean>;
-
 declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureApiKeyApproved, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, isCodeToolType, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, updateCustomModel, updateDefaultModel, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, detectInstalledVersion, ensureApiKeyApproved, ensureClaudeDir, executeInstallMethod, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, handleInstallFailure, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, installCodex, isClaudeCodeInstalled, isCodeToolType, isCodexInstalled, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, selectInstallMethod, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, uninstallCodeTool, updateCustomModel, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, CodeToolType, InstallationStatus, McpServerConfig, McpService, SupportedLang };

package/dist/index.d.ts

@@ -137,6 +137,10 @@ interface ApiConfig {
     key: string;
     authType?: 'auth_token' | 'api_key';
 }
+/**
+ * Installation method types for code tools
+ */
+type InstallMethod = 'npm' | 'homebrew' | 'curl' | 'powershell' | 'cmd';
 
 declare function ensureClaudeDir(): void;
 declare function backupExistingConfig(): string | null;
@@ -181,8 +185,29 @@ declare function switchToOfficialLogin(): boolean;
  */
 declare function promptApiConfigurationAction(): Promise<'modify-partial' | 'modify-all' | 'keep-existing' | null>;
 
+declare function getPlatform(): 'windows' | 'macos' | 'linux';
+declare function commandExists(command: string): Promise<boolean>;
+/**
+ * Get recommended install methods for a code tool based on current platform
+ * Returns methods in priority order (most recommended first)
+ */
+type CodeType = 'claude-code' | 'codex';
+
 declare function isClaudeCodeInstalled(): Promise<boolean>;
-declare function installClaudeCode(): Promise<void>;
+/**
+ * Install Claude Code with method selection support
+ * @param skipMethodSelection - If true, use default npm installation
+ */
+declare function installClaudeCode(skipMethodSelection?: boolean): Promise<void>;
+/**
+ * Check if Codex is installed
+ */
+declare function isCodexInstalled(): Promise<boolean>;
+/**
+ * Install Codex with method selection support
+ * @param skipMethodSelection - If true, use default npm installation
+ */
+declare function installCodex(skipMethodSelection?: boolean): Promise<void>;
 /**
  * Check if local Claude Code installation exists
  */
@@ -201,10 +226,33 @@ declare function getInstallationStatus(): Promise<InstallationStatus>;
  */
 declare function removeLocalClaudeCode(): Promise<void>;
 /**
- * Set installMethod to 'npm' in ~/.claude.json
+ * Uninstall code tool based on install method
+ * @param codeType - Type of code tool to uninstall
+ * @returns true if uninstalled successfully
+ */
+declare function uninstallCodeTool(codeType: CodeType): Promise<boolean>;
+/**
+ * Set installMethod in both ~/.claude.json and zcf-config
  * This ensures Claude Code knows it was installed via npm for proper auto-updates
  */
-declare function setInstallMethod(method?: 'npm' | 'native'): Promise<void>;
+declare function setInstallMethod(method?: InstallMethod | 'native', codeType?: CodeType): Promise<void>;
+/**
+ * Detect installed version of a code tool
+ * Returns version string or null if not installed
+ */
+declare function detectInstalledVersion(codeType: CodeType): Promise<string | null>;
+/**
+ * Select installation method interactively
+ */
+declare function selectInstallMethod(codeType: CodeType, excludeMethods?: InstallMethod[]): Promise<InstallMethod | null>;
+/**
+ * Execute installation using specified method
+ */
+declare function executeInstallMethod(method: InstallMethod, codeType: CodeType): Promise<boolean>;
+/**
+ * Handle installation failure with retry options
+ */
+declare function handleInstallFailure(codeType: CodeType, failedMethods: InstallMethod[]): Promise<boolean>;
 
 /**
  * Clean up and deduplicate permissions array
@@ -226,12 +274,9 @@ declare function cleanupPermissions(templatePermissions: string[], userPermissio
  */
 declare function mergeAndCleanPermissions(templatePermissions: string[] | undefined, userPermissions: string[] | undefined): string[];
 
-declare function getPlatform(): 'windows' | 'macos' | 'linux';
-declare function commandExists(command: string): Promise<boolean>;
-
 declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureApiKeyApproved, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, isCodeToolType, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, updateCustomModel, updateDefaultModel, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, detectInstalledVersion, ensureApiKeyApproved, ensureClaudeDir, executeInstallMethod, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, handleInstallFailure, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, installCodex, isClaudeCodeInstalled, isCodeToolType, isCodexInstalled, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, selectInstallMethod, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, uninstallCodeTool, updateCustomModel, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, CodeToolType, InstallationStatus, McpServerConfig, McpService, SupportedLang };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { z as AI_OUTPUT_LANGUAGES, A as API_DEFAULT_URL, v as API_ENV_KEY, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, h as CLAUDE_VSC_CONFIG_FILE, n as CODEX_AGENTS_FILE, l as CODEX_AUTH_FILE, k as CODEX_CONFIG_FILE, j as CODEX_DIR, p as CODEX_PROMPTS_DIR, t as CODE_TOOL_ALIASES, s as CODE_TOOL_BANNERS, r as CODE_TOOL_TYPES, f as ClAUDE_CONFIG_FILE, D as DEFAULT_CODE_TOOL_TYPE, y as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILES, S as SETTINGS_FILE, x as SUPPORTED_LANGS, Z as ZCF_CONFIG_DIR, q as ZCF_CONFIG_FILE, M as addCompletedOnboarding, a1 as applyAiLanguageDirective, T as backupExistingConfig, H as backupMcpConfig, J as buildMcpServerConfig, c as cleanupPermissions, a as commandExists, V as configureApi, U as copyConfigFiles, N as ensureApiKeyApproved, R as ensureClaudeDir, K as fixWindowsMcpConfig, B as getAiOutputLanguageLabel, a0 as getExistingApiConfig, $ as getExistingModelConfig, a7 as getInstallationStatus, E as getMcpConfigPath, g as getPlatform, b as importRecommendedEnv, d as importRecommendedPermissions, i as init, a5 as installClaudeCode, a4 as isClaudeCodeInstalled, u as isCodeToolType, a6 as isLocalClaudeCodeInstalled, P as manageApiKeyApproval, m as mergeAndCleanPermissions, W as mergeConfigs, I as mergeMcpServers, _ as mergeSettingsFile, o as openSettingsJson, a3 as promptApiConfigurationAction, F as readMcpConfig, O as removeApiKeyFromRejected, a8 as removeLocalClaudeCode, w as resolveCodeToolType, a9 as setInstallMethod, Q as setPrimaryApiKey, a2 as switchToOfficialLogin, X as updateCustomModel, Y as updateDefaultModel, G as writeMcpConfig } from './chunks/simple-config.mjs';
+export { z as AI_OUTPUT_LANGUAGES, A as API_DEFAULT_URL, v as API_ENV_KEY, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, h as CLAUDE_VSC_CONFIG_FILE, n as CODEX_AGENTS_FILE, l as CODEX_AUTH_FILE, k as CODEX_CONFIG_FILE, j as CODEX_DIR, p as CODEX_PROMPTS_DIR, t as CODE_TOOL_ALIASES, s as CODE_TOOL_BANNERS, r as CODE_TOOL_TYPES, f as ClAUDE_CONFIG_FILE, D as DEFAULT_CODE_TOOL_TYPE, y as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILES, S as SETTINGS_FILE, x as SUPPORTED_LANGS, Z as ZCF_CONFIG_DIR, q as ZCF_CONFIG_FILE, M as addCompletedOnboarding, a1 as applyAiLanguageDirective, T as backupExistingConfig, H as backupMcpConfig, J as buildMcpServerConfig, c as cleanupPermissions, a as commandExists, V as configureApi, U as copyConfigFiles, ad as detectInstalledVersion, N as ensureApiKeyApproved, R as ensureClaudeDir, af as executeInstallMethod, K as fixWindowsMcpConfig, B as getAiOutputLanguageLabel, a0 as getExistingApiConfig, $ as getExistingModelConfig, a9 as getInstallationStatus, E as getMcpConfigPath, g as getPlatform, ag as handleInstallFailure, b as importRecommendedEnv, d as importRecommendedPermissions, i as init, a5 as installClaudeCode, a7 as installCodex, a4 as isClaudeCodeInstalled, u as isCodeToolType, a6 as isCodexInstalled, a8 as isLocalClaudeCodeInstalled, P as manageApiKeyApproval, m as mergeAndCleanPermissions, W as mergeConfigs, I as mergeMcpServers, _ as mergeSettingsFile, o as openSettingsJson, a3 as promptApiConfigurationAction, F as readMcpConfig, O as removeApiKeyFromRejected, aa as removeLocalClaudeCode, w as resolveCodeToolType, ae as selectInstallMethod, ac as setInstallMethod, Q as setPrimaryApiKey, a2 as switchToOfficialLogin, ab as uninstallCodeTool, X as updateCustomModel, Y as updateDefaultModel, G as writeMcpConfig } from './chunks/simple-config.mjs';
 import 'node:fs';
 import 'node:process';
 import 'ansis';
@@ -9,6 +9,7 @@ import 'node:util';
 import 'dayjs';
 import 'pathe';
 import 'node:url';
+import 'inquirer-toggle';
 import 'ora';
 import 'semver';
 import 'smol-toml';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "3.3.3",
+  "version": "3.4.0",
   "description": "Zero-Config Code Flow - One-click configuration tool for Code Cli",
   "author": {
     "name": "Miao Da",
@@ -52,6 +52,7 @@
     "i18next": "^25.5.2",
     "i18next-fs-backend": "^2.6.0",
     "inquirer": "^12.9.6",
+    "inquirer-toggle": "^1.0.1",
     "ora": "^9.0.0",
     "pathe": "^2.0.3",
     "semver": "^7.7.2",