ccconfig 1.4.3 → 1.5.1

package/README.md

@@ -264,6 +264,46 @@ Do you want to set ANTHROPIC_SMALL_FAST_MODEL? (y/N) [n]:
 - Use `ccconfig start work` to launch Claude Code with the updated profile
 - Or use `ccconfig use work` to activate it in current shell
 
+### Copy Configuration (fork)
+
+If you need to create a new configuration based on an existing one, use the `fork` command:
+
+```bash
+# Fork a configuration interactively
+ccconfig fork work
+
+# The tool will:
+# 1. Ask for a new configuration name
+# 2. Copy all environment variables from the source
+# 3. Allow you to update values (press Enter to keep current value)
+```
+
+**Example:**
+```bash
+$ ccconfig fork work
+Please enter source configuration name to copy from: work
+Please enter new configuration name: work-dev
+Creating configuration 'work-dev' from 'work'...
+Press Enter to keep current value/default, or enter new value to update
+
+ANTHROPIC_BASE_URL [https://api.company.com]: https://dev-api.company.com
+ANTHROPIC_AUTH_TOKEN [sk-ant-api...]: <press Enter to keep>
+ANTHROPIC_API_KEY [sk-...]: <press Enter to keep>
+ANTHROPIC_MODEL [claude-sonnet-4-5-20250929]: <press Enter to keep>
+
+✓ Configuration 'work-dev' created from 'work'
+Environment variables:
+  ANTHROPIC_BASE_URL=https://dev-api.company.com
+  ANTHROPIC_AUTH_TOKEN=sk-ant-api...
+  ANTHROPIC_API_KEY=sk-...
+  ANTHROPIC_MODEL=claude-sonnet-4-5-20250929
+
+Run the following command to activate:
+  ccconfig use work-dev
+```
+
+This is useful when you need similar configurations with slight variations (e.g., production vs development endpoints).
+
 ### Shell Completion
 
 ccconfig supports shell completion for commands, profile names, and options. This makes it easier to discover and use commands.

package/README_zh.md

@@ -264,6 +264,46 @@ Do you want to set ANTHROPIC_SMALL_FAST_MODEL? (y/N) [n]:
 - 使用 `ccconfig start work` 以更新后的配置启动 Claude Code
 - 或使用 `ccconfig use work` 在当前 shell 中激活配置
 
+### 复制配置 (fork)
+
+如果您需要基于现有配置创建新配置，使用 `fork` 命令：
+
+```bash
+# 交互式复制配置
+ccconfig fork work
+
+# 工具会：
+# 1. 要求输入新配置名称
+# 2. 从源配置复制所有环境变量
+# 3. 允许您更新值（按 Enter 保持当前值）
+```
+
+**示例：**
+```bash
+$ ccconfig fork work
+Please enter source configuration name to copy from: work
+Please enter new configuration name: work-dev
+Creating configuration 'work-dev' from 'work'...
+Press Enter to keep current value/default, or enter new value to update
+
+ANTHROPIC_BASE_URL [https://api.company.com]: https://dev-api.company.com
+ANTHROPIC_AUTH_TOKEN [sk-ant-api...]: <按 Enter 保持不变>
+ANTHROPIC_API_KEY [sk-...]: <按 Enter 保持不变>
+ANTHROPIC_MODEL [claude-sonnet-4-5-20250929]: <按 Enter 保持不变>
+
+✓ Configuration 'work-dev' created from 'work'
+Environment variables:
+  ANTHROPIC_BASE_URL=https://dev-api.company.com
+  ANTHROPIC_AUTH_TOKEN=sk-ant-api...
+  ANTHROPIC_API_KEY=sk-...
+  ANTHROPIC_MODEL=claude-sonnet-4-5-20250929
+
+Run the following command to activate:
+  ccconfig use work-dev
+```
+
+当您需要相似配置但略有差异时很有用（例如生产环境与开发环境端点）。
+
 ### Shell 自动补全
 
 ccconfig 支持命令、配置名称和选项的 shell 自动补全，让您更容易发现和使用命令。

package/ccconfig.js

@@ -89,8 +89,8 @@ function ensureProfileAvailable(
 
 // All supported commands
 const COMMANDS = [
-  'list', 'ls', 'add', 'update', 'use', 'start', 'safe-start', 'remove', 'rm',
-  'current', 'mode', 'env', 'edit', 'completion'
+  'list', 'ls', 'add', 'update', 'fork', 'use', 'start', 'safe-start', 'remove', 'rm',
+  'current', 'mode', 'env', 'completion'
 ];
 
 // ccconfig markers for shell config files
@@ -688,9 +688,8 @@ async function add(name) {
     if (profilesMap[name]) {
       console.error(`Error: Configuration '${name}' already exists`);
       console.error('');
-      console.error('To modify this configuration, use one of:');
-      console.error(`  ccconfig update ${name}    # Interactive update`);
-      console.error(`  ccconfig edit              # Manual edit`);
+      console.error('To modify this configuration, use:');
+      console.error(`  ccconfig update ${name}`);
       process.exit(1);
     }
 
@@ -704,18 +703,60 @@ async function add(name) {
 
     console.log(`✓ Configuration '${name}' added`);
     console.log('');
-    console.log('Run the following command to activate:');
-    console.log(`  ccconfig use ${name}`);
-    console.log('');
-    console.log('Saved environment variables:');
-    displayEnvVars(envVars);
+
+    // Check if claude binary exists before offering to start
+    let claudeAvailable = false;
+    try {
+      const command =
+          process.platform === 'win32' ? 'where claude' : 'which claude';
+      execSync(command, {stdio: 'pipe'});
+      claudeAvailable = true;
+    } catch (err) {
+      // Claude not found, don't offer to start
+    }
+
+    // Ask if user wants to start Claude Code with this profile immediately
+    const shouldStart = claudeAvailable ?
+        await helper.ask(`Start Claude Code with ${name} now? (yes/no)`, 'no') :
+        'no';
+    const normalized = shouldStart.trim().toLowerCase();
+
     console.log('');
-    console.log('This information has been saved to:');
-    console.log(`  ${PROFILES_FILE}`);
-    console.log(
-        'You can edit this file directly to further customize the profile:');
-    console.log(`  vim ${PROFILES_FILE}`);
-    console.log('Or run ccconfig edit to open it with your preferred editor');
+
+    // Create auto-execute output manager (RAII-style)
+    const output = (() => {
+      let executed = false;
+      return {
+        execute: () => {
+          if (!executed) {
+            console.log('');
+            console.log(`Configuration '${name}' summary:`);
+            console.log('');
+            console.log('Saved environment variables:');
+            displayEnvVars(envVars);
+            console.log('');
+            console.log(`To start Claude Code with this configuration:`);
+            console.log(`  ccconfig start ${name}`);
+            console.log('');
+            console.log('To update this configuration:');
+            console.log(`  ccconfig update ${name}`);
+            console.log('');
+            console.log('Configuration saved to:');
+            console.log(`  ${PROFILES_FILE}`);
+            executed = true;
+          }
+        }
+      };
+    })();
+
+    // Attempt to start Claude (if user chose yes), deferring output to exit
+    const shouldStartClaude = normalized === 'yes' || normalized === 'y';
+    if (shouldStartClaude) {
+      start(name, [], {onExit: output.execute});
+    } else {
+      // If not starting Claude, show output immediately
+      output.execute();
+    }
   } finally {
     helper.close();
   }
@@ -778,20 +819,105 @@ async function update(name) {
   }
 }
 
+/**
+ * Fork (copy) existing configuration
+ */
+async function fork(sourceName) {
+  initIfNeeded();
+  requireInteractive('forking configurations');
+
+  const helper = new ReadlineHelper();
+
+  try {
+    if (!sourceName) {
+      sourceName = await helper.ask('Please enter source configuration name to copy from');
+    }
+
+    validateConfigName(sourceName);
+
+    const {profile: sourceProfile} = ensureProfileAvailable(sourceName, {
+      allowEmptyEnv: true,
+      onEmptyProfiles: () => {
+        console.error('Error: Configuration file does not exist');
+      },
+      onMissingProfile: () => {
+        console.error(`Error: Configuration '${sourceName}' does not exist`);
+        console.error('');
+        console.error('Run ccconfig list to see available configurations');
+      }
+    });
+
+    const profiles = loadProfiles() || {profiles: {}};
+    const profilesMap = getProfilesMap(profiles);
+
+    // Ask for new name with validation loop (default to source name)
+    let newName = '';
+    while (true) {
+      newName = await helper.ask(
+          `Please enter new configuration name`, sourceName);
+
+      // Validate name format
+      try {
+        validateConfigName(newName);
+      } catch (error) {
+        // validateConfigName calls process.exit, but just in case
+        continue;
+      }
+
+      // Check if name already exists
+      if (profilesMap[newName]) {
+        console.error(`Error: Configuration '${newName}' already exists`);
+        console.error('Please choose a different name.');
+        console.error('');
+        continue;
+      }
+
+      // Name is valid and unique
+      break;
+    }
+
+    console.log(`Creating configuration '${newName}' from '${sourceName}'...`);
+    console.log('Press Enter to keep current value/default, or enter new value to update');
+    console.log('');
+
+    // Get environment variables (inherited from source)
+    const existingEnv = sourceProfile.env || {};
+    const envVars = await helper.askEnvVars(existingEnv);
+
+    // Now save everything at once
+    profilesMap[newName] = {env: envVars};
+    saveProfiles(profiles);
+
+    console.log(`✓ Configuration '${newName}' created from '${sourceName}'`);
+    console.log('');
+    console.log('Environment variables:');
+    displayEnvVars(envVars);
+    console.log('');
+    console.log('Run the following command to activate:');
+    console.log(`  ccconfig use ${newName}`);
+
+  } finally {
+    helper.close();
+  }
+}
+
 /**
  * Remove configuration
  */
-function remove(name) {
+async function remove(name) {
   if (!name) {
     console.error('Error: Missing configuration name');
     console.error('Usage: ccconfig remove <name>');
     process.exit(1);
   }
 
+  // Check if terminal is interactive before proceeding
+  requireInteractive('removing configurations');
+
   // Validate configuration name
   validateConfigName(name);
 
-  const {profiles} = ensureProfileAvailable(name, {
+  const {profile, profiles} = ensureProfileAvailable(name, {
     allowEmptyEnv: true,
     onEmptyProfiles: () => {
       console.error('Error: Configuration file does not exist');
@@ -801,9 +927,45 @@ function remove(name) {
     }
   });
 
-  delete getProfilesMap(profiles)[name];
-  saveProfiles(profiles);
-  console.log(`✓ Configuration '${name}' removed`);
+  // Display profile information before removal
+  console.log('');
+  console.log('WARNING: PERMANENT DELETION');
+  console.log('═══════════════════════════════════════════════════════════');
+  console.log('');
+  console.log(`Configuration to be removed: ${name}`);
+  console.log('');
+  console.log('Profile details:');
+  if (profile.env && Object.keys(profile.env).length > 0) {
+    displayEnvVars(profile.env, true, '  ');
+  } else {
+    console.log('  (no environment variables configured)');
+  }
+  console.log('');
+  console.log('This action CANNOT be undone!');
+  console.log('All configuration data for this profile will be \x1b[1mpermanently deleted\x1b[0m.');
+  console.log('');
+
+  // Ask for confirmation
+  const helper = new ReadlineHelper();
+  try {
+    const confirmation = await helper.ask(
+        `Are you sure you want to remove '${name}'? (yes/no)`, 'no');
+    const normalized = confirmation.trim().toLowerCase();
+
+    if (normalized !== 'yes' && normalized !== 'y') {
+      console.log('');
+      console.log('Operation cancelled.');
+      return;
+    }
+
+    // Proceed with removal
+    delete getProfilesMap(profiles)[name];
+    saveProfiles(profiles);
+    console.log('');
+    console.log(`✓ Configuration '${name}' removed`);
+  } finally {
+    helper.close();
+  }
 }
 
 /**
@@ -1262,25 +1424,6 @@ function current(showSecret = false) {
   console.log('═══════════════════════════════════════════');
 }
 
-/**
- * Show configuration file path
- */
-function edit() {
-  if (!fs.existsSync(PROFILES_FILE)) {
-    console.error('Error: Configuration file does not exist');
-    console.error('Please add a configuration first: ccconfig add <name>');
-    process.exit(1);
-  }
-
-  const editor = process.env.EDITOR || process.env.VISUAL || 'vim';
-
-  console.log('Configuration file path:');
-  console.log(`  ${PROFILES_FILE}`);
-  console.log('');
-  console.log('Open it with your preferred editor, for example:');
-  console.log(`  ${editor} ${PROFILES_FILE}`);
-}
-
 /**
  * Switch/view mode
  */
@@ -1376,9 +1519,10 @@ function env(format = 'bash') {
  * @param {Array} extraArgs - Additional arguments to pass to Claude
  * @param {Object} options - Options object
  * @param {boolean} options.safe - Whether to run in safe mode (default: false)
+ * @param {Function} options.onExit - Callback to execute before process exits
  */
 function startClaude(name, extraArgs = [], options = {}) {
-  const {safe = false} = options;
+  const {safe = false, onExit = null} = options;
   const commandName = safe ? 'safe-start' : 'start';
 
   if (!name) {
@@ -1531,6 +1675,11 @@ function startClaude(name, extraArgs = [], options = {}) {
     process.removeListener('SIGINT', signalHandler);
     process.removeListener('SIGTERM', signalHandler);
 
+    // Execute onExit callback before showing promotion message
+    if (typeof onExit === 'function') {
+      onExit();
+    }
+
     // Show project promotion message on exit
     console.log('');
     console.log('──────────────────────────────────────────');
@@ -1566,16 +1715,16 @@ function startClaude(name, extraArgs = [], options = {}) {
 /**
  * Start Claude Code with specified profile (auto-approve mode)
  */
-function start(name, extraArgs = []) {
-  return startClaude(name, extraArgs, {safe: false});
+function start(name, extraArgs = [], options = {}) {
+  return startClaude(name, extraArgs, {safe: false, ...options});
 }
 
 /**
  * Start Claude Code with specified profile (safe mode - requires permission
  * confirmation)
  */
-function safeStart(name, extraArgs = []) {
-  return startClaude(name, extraArgs, {safe: true});
+function safeStart(name, extraArgs = [], options = {}) {
+  return startClaude(name, extraArgs, {safe: true, ...options});
 }
 
 /**
@@ -1618,7 +1767,7 @@ _ccconfig_completions() {
       ;;
     2)
       case "\${prev}" in
-        use|start|safe-start|update|remove|rm)
+        use|start|safe-start|update|fork|remove|rm)
           COMPREPLY=( $(compgen -W "\${profiles}" -- \${cur}) )
           ;;
         mode)
@@ -1627,6 +1776,9 @@ _ccconfig_completions() {
         env)
           COMPREPLY=( $(compgen -W "bash zsh fish sh powershell pwsh dotenv" -- \${cur}) )
           ;;
+        completion)
+          COMPREPLY=( $(compgen -W "bash zsh fish powershell pwsh" -- \${cur}) )
+          ;;
       esac
       ;;
     3)
@@ -1655,6 +1807,7 @@ _ccconfig() {
     'ls:List all configurations'
     'add:Add new configuration'
     'update:Update existing configuration'
+    'fork:Copy existing configuration and update'
     'use:Switch to specified configuration'
     'start:Start Claude Code (auto-approve mode)'
     'safe-start:Start Claude Code (safe mode, requires confirmation)'
@@ -1663,7 +1816,6 @@ _ccconfig() {
     'current:Display current configuration'
     'mode:View or switch mode'
     'env:Output environment variables'
-    'edit:Show configuration file location'
   )
 
   modes=('settings' 'env')
@@ -1680,7 +1832,7 @@ _ccconfig() {
       ;;
     3)
       case $words[2] in
-        use|start|safe-start|update|remove|rm)
+        use|start|safe-start|update|fork|remove|rm)
           _describe 'profile' profiles
           ;;
         mode)
@@ -1689,6 +1841,11 @@ _ccconfig() {
         env)
           _describe 'format' formats
           ;;
+        completion)
+          local -a shells
+          shells=('bash' 'zsh' 'fish' 'powershell' 'pwsh')
+          _describe 'shell' shells
+          ;;
       esac
       ;;
     4)
@@ -1716,6 +1873,7 @@ complete -c ccconfig -f -n "__fish_use_subcommand" -a "list" -d "List all config
 complete -c ccconfig -f -n "__fish_use_subcommand" -a "ls" -d "List all configurations"
 complete -c ccconfig -f -n "__fish_use_subcommand" -a "add" -d "Add new configuration"
 complete -c ccconfig -f -n "__fish_use_subcommand" -a "update" -d "Update existing configuration"
+complete -c ccconfig -f -n "__fish_use_subcommand" -a "fork" -d "Copy existing configuration and update"
 complete -c ccconfig -f -n "__fish_use_subcommand" -a "use" -d "Switch to specified configuration"
 complete -c ccconfig -f -n "__fish_use_subcommand" -a "start" -d "Start Claude Code (auto-approve mode)"
 complete -c ccconfig -f -n "__fish_use_subcommand" -a "safe-start" -d "Start Claude Code (safe mode, requires confirmation)"
@@ -1724,7 +1882,6 @@ complete -c ccconfig -f -n "__fish_use_subcommand" -a "rm" -d "Remove configurat
 complete -c ccconfig -f -n "__fish_use_subcommand" -a "current" -d "Display current configuration"
 complete -c ccconfig -f -n "__fish_use_subcommand" -a "mode" -d "View or switch mode"
 complete -c ccconfig -f -n "__fish_use_subcommand" -a "env" -d "Output environment variables"
-complete -c ccconfig -f -n "__fish_use_subcommand" -a "edit" -d "Show configuration file location"
 
 # Get profile names dynamically
 function __ccconfig_profiles
@@ -1733,8 +1890,8 @@ function __ccconfig_profiles
   end
 end
 
-# Profile name completion for use, start, safe-start, update, remove
-complete -c ccconfig -f -n "__fish_seen_subcommand_from use start safe-start update remove rm" -a "(__ccconfig_profiles)"
+# Profile name completion for use, start, safe-start, update, fork, remove
+complete -c ccconfig -f -n "__fish_seen_subcommand_from use start safe-start update fork remove rm" -a "(__ccconfig_profiles)"
 
 # Mode options
 complete -c ccconfig -f -n "__fish_seen_subcommand_from mode" -a "settings env"
@@ -1742,6 +1899,9 @@ complete -c ccconfig -f -n "__fish_seen_subcommand_from mode" -a "settings env"
 # Env format options
 complete -c ccconfig -f -n "__fish_seen_subcommand_from env" -a "bash zsh fish sh powershell pwsh dotenv"
 
+# Completion shell options
+complete -c ccconfig -f -n "__fish_seen_subcommand_from completion" -a "bash zsh fish powershell pwsh"
+
 # Flags for use command
 complete -c ccconfig -f -n "__fish_seen_subcommand_from use" -s p -l permanent -d "Write permanently to shell config"
 
@@ -1776,7 +1936,7 @@ function Get-CconfigProfiles {
 Register-ArgumentCompleter -Native -CommandName ccconfig -ScriptBlock {
     param($wordToComplete, $commandAst, $cursorPosition)
 
-    $commands = @('list', 'ls', 'add', 'update', 'use', 'start', 'safe-start', 'remove', 'rm', 'current', 'mode', 'env', 'edit', 'completion')
+    $commands = @('list', 'ls', 'add', 'update', 'fork', 'use', 'start', 'safe-start', 'remove', 'rm', 'current', 'mode', 'env', 'completion')
     $modes = @('settings', 'env')
     $formats = @('bash', 'zsh', 'fish', 'sh', 'powershell', 'pwsh', 'dotenv')
 
@@ -1798,7 +1958,7 @@ Register-ArgumentCompleter -Native -CommandName ccconfig -ScriptBlock {
     # Second argument completions based on command
     if ($position -eq 2 -or ($position -eq 3 -and $wordToComplete)) {
         switch ($command) {
-            { $_ -in 'use', 'start', 'safe-start', 'update', 'remove', 'rm' } {
+            { $_ -in 'use', 'start', 'safe-start', 'update', 'fork', 'remove', 'rm' } {
                 Get-CconfigProfiles | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
                     [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
                 }
@@ -1875,6 +2035,8 @@ function help() {
       '  add [name]                                Add new configuration (interactive)');
   console.log(
       '  update [name]                             Update existing configuration (interactive)');
+  console.log(
+      '  fork [source-name]                        Copy existing configuration and update (interactive)');
   console.log(
       '  use <name> [-p|--permanent]               Switch to specified configuration');
   console.log(
@@ -1889,8 +2051,6 @@ function help() {
       '  mode [settings|env]                       View or switch mode');
   console.log(
       '  env [format]                              Output environment variables (env mode)');
-  console.log(
-      '  edit                                      Show configuration file location');
   console.log(
       '  completion <bash|zsh|fish|pwsh>           Generate shell completion script');
   console.log('');
@@ -1999,9 +2159,12 @@ async function main() {
     case 'update':
       await update(filteredArgs[1]);
       break;
+    case 'fork':
+      await fork(filteredArgs[1]);
+      break;
     case 'remove':
     case 'rm':
-      remove(filteredArgs[1]);
+      await remove(filteredArgs[1]);
       break;
     case 'current':
       current(showSecret);
@@ -2012,9 +2175,6 @@ async function main() {
     case 'env':
       env(filteredArgs[1] || 'bash');
       break;
-    case 'edit':
-      edit();
-      break;
     case 'start':
       if (!filteredArgs[1]) {
         console.error('Error: Missing configuration name');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccconfig",
-  "version": "1.4.3",
+  "version": "1.5.1",
   "description": "Cross-platform Claude Code configuration switching tool",
   "main": "ccconfig.js",
   "bin": {