ccconfig 1.5.0 → 1.5.2

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,7 +89,7 @@ function ensureProfileAvailable(
 
 // All supported commands
 const COMMANDS = [
-  'list', 'ls', 'add', 'update', 'use', 'start', 'safe-start', 'remove', 'rm',
+  'list', 'ls', 'add', 'update', 'fork', 'use', 'start', 'safe-start', 'remove', 'rm',
   'current', 'mode', 'env', 'completion'
 ];
 
@@ -180,46 +180,61 @@ class ReadlineHelper {
 
   async ask(question, defaultValue = '', options = {}) {
     this.ensureInterface();
-    const {brackets = 'parentheses'} = options;
+    const {brackets = 'parentheses', prefill = false} = options;
     const left = brackets === 'square' ? '[' : '(';
     const right = brackets === 'square' ? ']' : ')';
-    const suffix = defaultValue ? ` ${left}${defaultValue}${right}` : '';
+    // Don't show value in brackets if it will be pre-filled
+    const suffix = (defaultValue && !prefill) ? ` ${left}${defaultValue}${right}` : '';
 
     return new Promise(resolve => {
       this.rl.question(`${question}${suffix}: `, answer => {
         const trimmed = answer.trim();
         resolve(trimmed || defaultValue);
       });
+      // Pre-fill input with default value if prefill option is enabled
+      if (prefill && defaultValue) {
+        this.rl.write(defaultValue);
+      }
     });
   }
 
   async askEnvVars(existingEnv = {}) {
+    const hasExisting = key => !!existingEnv[key];
+
     const baseUrl = await this.ask(
         'ANTHROPIC_BASE_URL (press Enter to keep current/default)',
-        existingEnv.ANTHROPIC_BASE_URL || 'https://api.anthropic.com',
-        {brackets: existingEnv.ANTHROPIC_BASE_URL ? 'square' : 'parentheses'});
+        existingEnv.ANTHROPIC_BASE_URL || 'https://api.anthropic.com', {
+          brackets: hasExisting('ANTHROPIC_BASE_URL') ? 'square' : 'parentheses',
+          prefill: hasExisting('ANTHROPIC_BASE_URL')
+        });
 
     const authToken = await this.ask(
         'ANTHROPIC_AUTH_TOKEN (press Enter to keep current/set empty)',
         existingEnv.ANTHROPIC_AUTH_TOKEN || '', {
-          brackets: existingEnv.ANTHROPIC_AUTH_TOKEN ? 'square' : 'parentheses'
+          brackets: hasExisting('ANTHROPIC_AUTH_TOKEN') ? 'square' : 'parentheses',
+          prefill: hasExisting('ANTHROPIC_AUTH_TOKEN')
         });
 
     const apiKey = await this.ask(
         'ANTHROPIC_API_KEY (press Enter to keep current/set empty)',
-        existingEnv.ANTHROPIC_API_KEY || '',
-        {brackets: existingEnv.ANTHROPIC_API_KEY ? 'square' : 'parentheses'});
+        existingEnv.ANTHROPIC_API_KEY || '', {
+          brackets: hasExisting('ANTHROPIC_API_KEY') ? 'square' : 'parentheses',
+          prefill: hasExisting('ANTHROPIC_API_KEY')
+        });
 
     const model = await this.ask(
         'ANTHROPIC_MODEL (press Enter to skip/keep current)',
-        existingEnv.ANTHROPIC_MODEL || '',
-        {brackets: existingEnv.ANTHROPIC_MODEL ? 'square' : 'parentheses'});
+        existingEnv.ANTHROPIC_MODEL || '', {
+          brackets: hasExisting('ANTHROPIC_MODEL') ? 'square' : 'parentheses',
+          prefill: hasExisting('ANTHROPIC_MODEL')
+        });
 
     const smallFastModel = await this.ask(
         'ANTHROPIC_SMALL_FAST_MODEL (press Enter to skip/keep current)',
         existingEnv.ANTHROPIC_SMALL_FAST_MODEL || '', {
-          brackets: existingEnv.ANTHROPIC_SMALL_FAST_MODEL ? 'square' :
-                                                             'parentheses'
+          brackets:
+              hasExisting('ANTHROPIC_SMALL_FAST_MODEL') ? 'square' : 'parentheses',
+          prefill: hasExisting('ANTHROPIC_SMALL_FAST_MODEL')
         });
 
     const envVars = {
@@ -819,6 +834,88 @@ 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
  */
@@ -1685,7 +1782,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)
@@ -1694,6 +1791,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)
@@ -1722,6 +1822,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)'
@@ -1746,7 +1847,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)
@@ -1755,6 +1856,11 @@ _ccconfig() {
         env)
           _describe 'format' formats
           ;;
+        completion)
+          local -a shells
+          shells=('bash' 'zsh' 'fish' 'powershell' 'pwsh')
+          _describe 'shell' shells
+          ;;
       esac
       ;;
     4)
@@ -1782,6 +1888,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)"
@@ -1798,8 +1905,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"
@@ -1807,6 +1914,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"
 
@@ -1841,7 +1951,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', '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')
 
@@ -1863,7 +1973,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', $_)
                 }
@@ -1940,6 +2050,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(
@@ -2062,6 +2174,9 @@ async function main() {
     case 'update':
       await update(filteredArgs[1]);
       break;
+    case 'fork':
+      await fork(filteredArgs[1]);
+      break;
     case 'remove':
     case 'rm':
       await remove(filteredArgs[1]);

package/package.json

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