ccconfig 1.4.1 → 1.4.3

package/README.md

@@ -38,7 +38,7 @@ ccconfig use personal --permanent  # or use -p for short
 npm install -g ccconfig
 ```
 
-### Method 1: Direct Start Mode (Recommended 🚀)
+### Method 1: Direct Start Mode (Recommended)
 
 The easiest way to use ccconfig - directly start Claude Code with a specific profile:
 
@@ -64,21 +64,21 @@ ccconfig safe-start work         # Safe mode (requires confirmation for each com
 - **`ccconfig start`** - Auto-approve mode
   - Automatically adds `--dangerously-skip-permissions` flag
   - Commands execute without confirmation prompts
-  - ⚠️ **Only use with profiles you trust**
+  - **Only use with profiles you trust**
   - Perfect for: personal projects, trusted company profiles, rapid development
 
 - **`ccconfig safe-start`** - Safe mode
   - Does NOT add `--dangerously-skip-permissions`
   - Requires manual confirmation before executing each command
-  - ✅ **Recommended for production or untrusted environments**
+  - **Recommended for production or untrusted environments**
   - Perfect for: production systems, new profiles, sensitive data
 
 **Advantages:**
-- ✅ No shell configuration needed
-- ✅ No manual switching required
-- ✅ Environment variables automatically injected
-- ✅ Works across all shells
-- ✅ Pass additional arguments: `ccconfig start work /path/to/project --verbose`
+- No shell configuration needed
+- No manual switching required
+- Environment variables automatically injected
+- Works across all shells
+- Pass additional arguments: `ccconfig start work /path/to/project --verbose`
 
 ### Method 2: Manual Switch Mode
 
@@ -269,11 +269,11 @@ Do you want to set ANTHROPIC_SMALL_FAST_MODEL? (y/N) [n]:
 ccconfig supports shell completion for commands, profile names, and options. This makes it easier to discover and use commands.
 
 **Features:**
-- ✅ Command completion (list, add, update, use, remove, etc.)
-- ✅ Profile name completion (dynamically reads from your configurations)
-- ✅ Option completion (--permanent, --show-secret, etc.)
-- ✅ Mode completion (settings, env)
-- ✅ Format completion (bash, zsh, fish, etc.)
+- Command completion (list, add, update, use, remove, etc.)
+- Profile name completion (dynamically reads from your configurations)
+- Option completion (--permanent, --show-secret, etc.)
+- Mode completion (settings, env)
+- Format completion (bash, zsh, fish, etc.)
 
 **Installation:**
 

package/README_zh.md

@@ -38,7 +38,7 @@ ccconfig use personal --permanent  # 或使用 -p 简写
 npm install -g ccconfig
 ```
 
-### 方式 1：直接启动模式（推荐 🚀）
+### 方式 1：直接启动模式（推荐）
 
 最简单的使用方式 - 直接使用指定配置启动 Claude Code：
 
@@ -64,21 +64,21 @@ ccconfig safe-start work         # 安全模式（每个命令需要确认）
 - **`ccconfig start`** - 自动批准模式
   - 自动添加 `--dangerously-skip-permissions` 标志
   - 命令无需确认直接执行
-  - ⚠️ **仅在您信任的配置中使用**
+  - **仅在您信任的配置中使用**
   - 适用场景：个人项目、可信的公司配置、快速开发
 
 - **`ccconfig safe-start`** - 安全模式
   - 不添加 `--dangerously-skip-permissions`
   - 执行每个命令前需要手动确认
-  - ✅ **推荐用于生产环境或不可信环境**
+  - **推荐用于生产环境或不可信环境**
   - 适用场景：生产系统、新配置、敏感数据
 
 **优势：**
-- ✅ 无需配置 shell
-- ✅ 无需手动切换
-- ✅ 自动注入环境变量
-- ✅ 支持所有 shell
-- ✅ 可传递额外参数：`ccconfig start work /path/to/project --verbose`
+- 无需配置 shell
+- 无需手动切换
+- 自动注入环境变量
+- 支持所有 shell
+- 可传递额外参数：`ccconfig start work /path/to/project --verbose`
 
 ### 方式 2：手动切换模式
 
@@ -269,11 +269,11 @@ Do you want to set ANTHROPIC_SMALL_FAST_MODEL? (y/N) [n]:
 ccconfig 支持命令、配置名称和选项的 shell 自动补全，让您更容易发现和使用命令。
 
 **功能：**
-- ✅ 命令补全 (list, add, update, use, remove 等)
-- ✅ 配置名称补全（动态读取您的配置）
-- ✅ 选项补全 (--permanent, --show-secret 等)
-- ✅ 模式补全 (settings, env)
-- ✅ 格式补全 (bash, zsh, fish 等)
+- 命令补全 (list, add, update, use, remove 等)
+- 配置名称补全（动态读取您的配置）
+- 选项补全 (--permanent, --show-secret 等)
+- 模式补全 (settings, env)
+- 格式补全 (bash, zsh, fish 等)
 
 **安装：**
 

package/ccconfig.js

@@ -4,7 +4,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const readline = require('readline');
-const { spawn, execSync } = require('child_process');
+const {spawn, execSync} = require('child_process');
 
 // Configuration file paths
 const CONFIG_DIR = path.join(os.homedir(), '.config', 'ccconfig');
@@ -52,7 +52,11 @@ function ensureProfilesAvailable({onEmpty} = {}) {
 }
 
 function ensureProfileAvailable(
-    name, {allowEmptyEnv = false, onEmptyProfiles, onMissingProfile, onEmptyEnv} = {}) {
+    name,
+    {allowEmptyEnv = false,
+     onEmptyProfiles,
+     onMissingProfile,
+     onEmptyEnv} = {}) {
   const profiles = ensureProfilesAvailable({onEmpty: onEmptyProfiles});
   const profilesMap = getProfilesMap(profiles);
   const profile = profilesMap[name];
@@ -68,7 +72,8 @@ function ensureProfileAvailable(
     process.exit(1);
   }
 
-  if (!allowEmptyEnv && (!profile.env || Object.keys(profile.env).length === 0)) {
+  if (!allowEmptyEnv &&
+      (!profile.env || Object.keys(profile.env).length === 0)) {
     if (typeof onEmptyEnv === 'function') {
       onEmptyEnv();
     } else {
@@ -83,7 +88,10 @@ function ensureProfileAvailable(
 }
 
 // All supported commands
-const COMMANDS = ['list', 'ls', 'add', 'update', 'use', 'start', 'safe-start', 'remove', 'rm', 'current', 'mode', 'env', 'edit', 'completion'];
+const COMMANDS = [
+  'list', 'ls', 'add', 'update', 'use', 'start', 'safe-start', 'remove', 'rm',
+  'current', 'mode', 'env', 'edit', 'completion'
+];
 
 // ccconfig markers for shell config files
 const SHELL_MARKERS = {
@@ -140,11 +148,16 @@ function printEnvVar(key, value, mask = true) {
  * Utility: Display environment variables with consistent formatting
  */
 function displayEnvVars(envVars, mask = true, indent = '  ') {
-  const keys = [ENV_KEYS.BASE_URL, ENV_KEYS.AUTH_TOKEN, ENV_KEYS.API_KEY, ENV_KEYS.MODEL, ENV_KEYS.SMALL_FAST_MODEL];
+  const keys = [
+    ENV_KEYS.BASE_URL, ENV_KEYS.AUTH_TOKEN, ENV_KEYS.API_KEY, ENV_KEYS.MODEL,
+    ENV_KEYS.SMALL_FAST_MODEL
+  ];
   for (const key of keys) {
     if (!(key in envVars)) continue;
     const value = envVars[key];
-    if (!value && key !== ENV_KEYS.BASE_URL && key !== ENV_KEYS.AUTH_TOKEN && key !== ENV_KEYS.API_KEY) continue;
+    if (!value && key !== ENV_KEYS.BASE_URL && key !== ENV_KEYS.AUTH_TOKEN &&
+        key !== ENV_KEYS.API_KEY)
+      continue;
     const displayValue = maskValue(key, value, mask);
     console.log(`${indent}${key}: ${displayValue || '(not set)'}`);
   }
@@ -160,16 +173,14 @@ class ReadlineHelper {
 
   ensureInterface() {
     if (!this.rl) {
-      this.rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-      });
+      this.rl = readline.createInterface(
+          {input: process.stdin, output: process.stdout});
     }
   }
 
   async ask(question, defaultValue = '', options = {}) {
     this.ensureInterface();
-    const { brackets = 'parentheses' } = options;
+    const {brackets = 'parentheses'} = options;
     const left = brackets === 'square' ? '[' : '(';
     const right = brackets === 'square' ? ']' : ')';
     const suffix = defaultValue ? ` ${left}${defaultValue}${right}` : '';
@@ -184,34 +195,32 @@ class ReadlineHelper {
 
   async askEnvVars(existingEnv = {}) {
     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' }
-    );
+        'ANTHROPIC_BASE_URL (press Enter to keep current/default)',
+        existingEnv.ANTHROPIC_BASE_URL || 'https://api.anthropic.com',
+        {brackets: existingEnv.ANTHROPIC_BASE_URL ? 'square' : 'parentheses'});
 
     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' }
-    );
+        'ANTHROPIC_AUTH_TOKEN (press Enter to keep current/set empty)',
+        existingEnv.ANTHROPIC_AUTH_TOKEN || '', {
+          brackets: existingEnv.ANTHROPIC_AUTH_TOKEN ? 'square' : 'parentheses'
+        });
 
     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' }
-    );
+        'ANTHROPIC_API_KEY (press Enter to keep current/set empty)',
+        existingEnv.ANTHROPIC_API_KEY || '',
+        {brackets: existingEnv.ANTHROPIC_API_KEY ? 'square' : 'parentheses'});
 
     const model = await this.ask(
-      'ANTHROPIC_MODEL (press Enter to skip/keep current)',
-      existingEnv.ANTHROPIC_MODEL || '',
-      { brackets: existingEnv.ANTHROPIC_MODEL ? 'square' : 'parentheses' }
-    );
+        'ANTHROPIC_MODEL (press Enter to skip/keep current)',
+        existingEnv.ANTHROPIC_MODEL || '',
+        {brackets: existingEnv.ANTHROPIC_MODEL ? 'square' : 'parentheses'});
 
     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' }
-    );
+        'ANTHROPIC_SMALL_FAST_MODEL (press Enter to skip/keep current)',
+        existingEnv.ANTHROPIC_SMALL_FAST_MODEL || '', {
+          brackets: existingEnv.ANTHROPIC_SMALL_FAST_MODEL ? 'square' :
+                                                             'parentheses'
+        });
 
     const envVars = {
       [ENV_KEYS.BASE_URL]: baseUrl || '',
@@ -249,14 +258,17 @@ function requireInteractive(commandName) {
  * Utility: Display environment variables section for current command
  */
 function displayEnvSection(envVars, showSecret) {
-  if (!envVars || (!envVars[ENV_KEYS.BASE_URL] && !envVars[ENV_KEYS.AUTH_TOKEN] && !envVars[ENV_KEYS.API_KEY])) {
+  if (!envVars ||
+      (!envVars[ENV_KEYS.BASE_URL] && !envVars[ENV_KEYS.AUTH_TOKEN] &&
+       !envVars[ENV_KEYS.API_KEY])) {
     console.log('  (not configured)');
     return;
   }
 
   const normalizedEnv = {
     [ENV_KEYS.BASE_URL]: envVars[ENV_KEYS.BASE_URL] || '(not set)',
-    [ENV_KEYS.AUTH_TOKEN]: envVars[ENV_KEYS.AUTH_TOKEN] || envVars[ENV_KEYS.API_KEY] || '(not set)',
+    [ENV_KEYS.AUTH_TOKEN]: envVars[ENV_KEYS.AUTH_TOKEN] ||
+        envVars[ENV_KEYS.API_KEY] || '(not set)',
     [ENV_KEYS.MODEL]: envVars[ENV_KEYS.MODEL],
     [ENV_KEYS.SMALL_FAST_MODEL]: envVars[ENV_KEYS.SMALL_FAST_MODEL]
   };
@@ -269,12 +281,14 @@ function displayEnvSection(envVars, showSecret) {
 
   // Display with aligned columns
   console.log(`  ${ENV_KEYS.BASE_URL}:   ${normalizedEnv[ENV_KEYS.BASE_URL]}`);
-  console.log(`  ${ENV_KEYS.AUTH_TOKEN}: ${normalizedEnv[ENV_KEYS.AUTH_TOKEN]}`);
+  console.log(
+      `  ${ENV_KEYS.AUTH_TOKEN}: ${normalizedEnv[ENV_KEYS.AUTH_TOKEN]}`);
   if (normalizedEnv[ENV_KEYS.MODEL]) {
     console.log(`  ${ENV_KEYS.MODEL}:      ${normalizedEnv[ENV_KEYS.MODEL]}`);
   }
   if (normalizedEnv[ENV_KEYS.SMALL_FAST_MODEL]) {
-    console.log(`  ${ENV_KEYS.SMALL_FAST_MODEL}: ${normalizedEnv[ENV_KEYS.SMALL_FAST_MODEL]}`);
+    console.log(`  ${ENV_KEYS.SMALL_FAST_MODEL}: ${
+        normalizedEnv[ENV_KEYS.SMALL_FAST_MODEL]}`);
   }
 }
 
@@ -315,7 +329,8 @@ function validateConfigName(name, allowEmpty = false) {
   // Limit length to prevent issues
   const MAX_NAME_LENGTH = 50;
   if (name.length > MAX_NAME_LENGTH) {
-    console.error(`Error: Configuration name too long (max ${MAX_NAME_LENGTH} characters)`);
+    console.error(`Error: Configuration name too long (max ${
+        MAX_NAME_LENGTH} characters)`);
     console.error(`Current length: ${name.length}`);
     process.exit(1);
   }
@@ -451,10 +466,10 @@ function writeEnvFile(envVars) {
     const lines = Object.entries(envVars).map(([key, value]) => {
       // Escape special characters to prevent injection
       const escapedValue = String(value ?? '')
-        .replace(/\\/g, '\\\\')
-        .replace(/\n/g, '\\n')
-        .replace(/\r/g, '\\r')
-        .replace(/\t/g, '\\t');
+                               .replace(/\\/g, '\\\\')
+                               .replace(/\n/g, '\\n')
+                               .replace(/\r/g, '\\r')
+                               .replace(/\t/g, '\\t');
       return `${key}=${escapedValue}`;
     });
     const content = lines.join('\n') + '\n';
@@ -481,17 +496,17 @@ function readEnvFile() {
     const content = fs.readFileSync(ENV_FILE, 'utf-8');
     const env = {};
     content.split('\n').forEach(line => {
-      // Only accept valid environment variable names: starts with letter or underscore,
-      // followed by letters, numbers, or underscores
+      // Only accept valid environment variable names: starts with letter or
+      // underscore, followed by letters, numbers, or underscores
       const match = line.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);
       if (match) {
         // Unescape special characters
         // IMPORTANT: Must unescape \\\\ first to avoid double-unescaping
         const unescapedValue = match[2]
-          .replace(/\\\\/g, '\\')
-          .replace(/\\n/g, '\n')
-          .replace(/\\r/g, '\r')
-          .replace(/\\t/g, '\t');
+                                   .replace(/\\\\/g, '\\')
+                                   .replace(/\\n/g, '\n')
+                                   .replace(/\\r/g, '\r')
+                                   .replace(/\\t/g, '\t');
         env[match[1]] = unescapedValue;
       }
     });
@@ -631,7 +646,8 @@ function list() {
       console.log(`    Model: ${profile.env.ANTHROPIC_MODEL}`);
     }
     if (profile.env && profile.env.ANTHROPIC_SMALL_FAST_MODEL) {
-      console.log(`    Small Fast Model: ${profile.env.ANTHROPIC_SMALL_FAST_MODEL}`);
+      console.log(
+          `    Small Fast Model: ${profile.env.ANTHROPIC_SMALL_FAST_MODEL}`);
     }
     console.log('');
   }
@@ -696,7 +712,8 @@ async function add(name) {
     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(
+        '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');
   } finally {
@@ -730,7 +747,8 @@ async function update(name) {
         console.error(`Error: Configuration '${name}' does not exist`);
         console.error('');
         console.error('Run ccconfig list to see available configurations');
-        console.error(`Or use 'ccconfig add ${name}' to create a new configuration`);
+        console.error(
+            `Or use 'ccconfig add ${name}' to create a new configuration`);
         process.exit(1);
       }
     });
@@ -738,7 +756,8 @@ async function update(name) {
     const existingEnv = profile.env || {};
 
     console.log(`Updating configuration '${name}'`);
-    console.log('Press Enter to keep current value/default, or enter new value to update');
+    console.log(
+        'Press Enter to keep current value/default, or enter new value to update');
     console.log('');
 
     const envVars = await helper.askEnvVars(existingEnv);
@@ -812,7 +831,9 @@ const ShellUtils = {
     },
     fish: (value) => {
       const str = value == null ? '' : String(value);
-      return str.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\$/g, '\\$');
+      return str.replace(/\\/g, '\\\\')
+          .replace(/"/g, '\\"')
+          .replace(/\$/g, '\\$');
     },
     pwsh: (value) => {
       const str = value == null ? '' : String(value);
@@ -827,10 +848,12 @@ const ShellUtils = {
     if (process.env.FISH_VERSION || shellPath.includes('fish')) {
       return 'fish';
     }
-    if (process.env.ZSH_NAME || process.env.ZSH_VERSION || shellPath.includes('zsh')) {
+    if (process.env.ZSH_NAME || process.env.ZSH_VERSION ||
+        shellPath.includes('zsh')) {
       return 'zsh';
     }
-    if (process.env.POWERSHELL_DISTRIBUTION_CHANNEL || shellPath.includes('pwsh') || shellPath.includes('powershell')) {
+    if (process.env.POWERSHELL_DISTRIBUTION_CHANNEL ||
+        shellPath.includes('pwsh') || shellPath.includes('powershell')) {
       return 'powershell';
     }
     if (shellPath.includes('bash')) {
@@ -851,14 +874,17 @@ const ShellUtils = {
     const configs = {
       fish: path.join(homeDir, '.config', 'fish', 'config.fish'),
       zsh: path.join(homeDir, '.zshrc'),
-      bash: process.platform === 'darwin'
-        ? (fs.existsSync(path.join(homeDir, '.bash_profile')) || !fs.existsSync(path.join(homeDir, '.bashrc'))
-          ? path.join(homeDir, '.bash_profile')
-          : path.join(homeDir, '.bashrc'))
-        : path.join(homeDir, '.bashrc'),
-      powershell: process.platform === 'win32'
-        ? path.join(process.env.USERPROFILE || homeDir, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1')
-        : path.join(homeDir, '.config', 'powershell', 'profile.ps1')
+      bash: process.platform === 'darwin' ?
+          (fs.existsSync(path.join(homeDir, '.bash_profile')) ||
+                   !fs.existsSync(path.join(homeDir, '.bashrc')) ?
+               path.join(homeDir, '.bash_profile') :
+               path.join(homeDir, '.bashrc')) :
+          path.join(homeDir, '.bashrc'),
+      powershell: process.platform === 'win32' ?
+          path.join(
+              process.env.USERPROFILE || homeDir, 'Documents', 'PowerShell',
+              'Microsoft.PowerShell_profile.ps1') :
+          path.join(homeDir, '.config', 'powershell', 'profile.ps1')
     };
     return configs[shellType];
   },
@@ -893,11 +919,10 @@ const ShellUtils = {
           break;
         case 'dotenv':
           const renderedValue = value == null ? '' : String(value);
-          const escapedValue = renderedValue
-            .replace(/\\/g, '\\\\')
-            .replace(/\n/g, '\\n')
-            .replace(/\r/g, '\\r')
-            .replace(/\t/g, '\\t');
+          const escapedValue = renderedValue.replace(/\\/g, '\\\\')
+                                   .replace(/\n/g, '\\n')
+                                   .replace(/\r/g, '\\r')
+                                   .replace(/\t/g, '\\t');
           lines.push(`${key}=${escapedValue}`);
           break;
       }
@@ -907,9 +932,15 @@ const ShellUtils = {
 };
 
 // Legacy function wrappers for backward compatibility
-function escapePosix(value) { return ShellUtils.escape.posix(value); }
-function escapeFish(value) { return ShellUtils.escape.fish(value); }
-function escapePwsh(value) { return ShellUtils.escape.pwsh(value); }
+function escapePosix(value) {
+  return ShellUtils.escape.posix(value);
+}
+function escapeFish(value) {
+  return ShellUtils.escape.fish(value);
+}
+function escapePwsh(value) {
+  return ShellUtils.escape.pwsh(value);
+}
 
 /**
  * Detect shell type and config file path
@@ -950,7 +981,8 @@ async function writePermanentEnv(envVars) {
   const maskedEnvLines = ShellUtils.formatEnvVars(maskedEnvVars, shell);
 
   const envBlock = `${marker}\n${envLines.join('\n')}\n${markerEnd}\n`;
-  const maskedEnvBlock = `${marker}\n${maskedEnvLines.join('\n')}\n${markerEnd}\n`;
+  const maskedEnvBlock =
+      `${marker}\n${maskedEnvLines.join('\n')}\n${markerEnd}\n`;
 
   // Display warning and confirmation
   console.log('');
@@ -1319,12 +1351,15 @@ function env(format = 'bash') {
   const envVars = getActiveEnvVars();
 
   if (!envVars || Object.keys(envVars).length === 0) {
-    console.error('Error: No available environment variable configuration found');
-    console.error('Please run ccconfig use <name> to select a configuration first');
+    console.error(
+        'Error: No available environment variable configuration found');
+    console.error(
+        'Please run ccconfig use <name> to select a configuration first');
     process.exit(1);
   }
 
-  const supportedFormats = ['fish', 'bash', 'zsh', 'sh', 'powershell', 'pwsh', 'dotenv'];
+  const supportedFormats =
+      ['fish', 'bash', 'zsh', 'sh', 'powershell', 'pwsh', 'dotenv'];
   if (!supportedFormats.includes(format)) {
     console.error(`Error: Unsupported format: ${format}`);
     console.error(`Supported formats: ${supportedFormats.join(', ')}`);
@@ -1343,7 +1378,7 @@ function env(format = 'bash') {
  * @param {boolean} options.safe - Whether to run in safe mode (default: false)
  */
 function startClaude(name, extraArgs = [], options = {}) {
-  const { safe = false } = options;
+  const {safe = false} = options;
   const commandName = safe ? 'safe-start' : 'start';
 
   if (!name) {
@@ -1373,8 +1408,9 @@ function startClaude(name, extraArgs = [], options = {}) {
 
   // Check if claude binary exists before proceeding
   try {
-    const command = process.platform === 'win32' ? 'where claude' : 'which claude';
-    execSync(command, { stdio: 'pipe' });
+    const command =
+        process.platform === 'win32' ? 'where claude' : 'which claude';
+    execSync(command, {stdio: 'pipe'});
   } catch (err) {
     console.error('Error: Claude Code CLI not found');
     console.error('');
@@ -1395,17 +1431,22 @@ function startClaude(name, extraArgs = [], options = {}) {
   }
 
   // Build Claude arguments based on mode
-  const claudeArgs = safe ? extraArgs : ['--dangerously-skip-permissions', ...extraArgs];
+  const claudeArgs =
+      safe ? extraArgs : ['--dangerously-skip-permissions', ...extraArgs];
 
   // Display mode-specific notes
   console.log('');
   if (safe) {
-    console.log('Note: Running in safe mode (permission confirmation required)');
-    console.log('      Claude Code will ask for confirmation before executing commands');
+    console.log(
+        'Note: Running in safe mode (permission confirmation required)');
+    console.log(
+        '      Claude Code will ask for confirmation before executing commands');
     console.log('      For automatic execution, use "ccconfig start" instead');
   } else {
-    console.log('Note: Starting with --dangerously-skip-permissions flag enabled');
-    console.log('      This allows Claude Code to execute commands without confirmation prompts');
+    console.log(
+        'Note: Starting with --dangerously-skip-permissions flag enabled');
+    console.log(
+        '      This allows Claude Code to execute commands without confirmation prompts');
     console.log('      Only use this with profiles you trust');
   }
   console.log('');
@@ -1420,7 +1461,10 @@ function startClaude(name, extraArgs = [], options = {}) {
   // Normalize all profile env values to strings (spawn requires string values)
   const normalizedEnv = {};
   for (const [key, value] of Object.entries(profile.env)) {
-    normalizedEnv[key] = String(value ?? '');
+    if (value === undefined || value === null) {
+      continue;
+    }
+    normalizedEnv[key] = typeof value === 'string' ? value : String(value);
   }
   const envVars = {...process.env, ...normalizedEnv};
 
@@ -1430,21 +1474,92 @@ function startClaude(name, extraArgs = [], options = {}) {
     stdio: 'inherit'  // Inherit stdin, stdout, stderr from parent process
   });
 
+  // Function to restore terminal state and exit
+  const exitGracefully = (code) => {
+    // Reset terminal to normal mode (in case it was left in raw mode)
+    if (process.stdin.isTTY && process.stdin.setRawMode) {
+      try {
+        process.stdin.setRawMode(false);
+      } catch (e) {
+        // Ignore errors during cleanup
+      }
+    }
+
+    const canResetTerminal = process.platform !== 'win32' &&
+        process.stdin.isTTY && process.stdout.isTTY;
+
+    // Use stty to restore terminal settings on Unix-like systems
+    // This is more comprehensive than just setRawMode
+    if (canResetTerminal) {
+      try {
+        // 'stty sane' restores terminal to sensible settings
+        // Use stdio: 'inherit' to ensure it operates on the same terminal
+        execSync('stty sane', {stdio: 'inherit'});
+      } catch (e) {
+        // If stty fails, try basic echo and icanon reset
+        try {
+          execSync('stty echo icanon', {stdio: 'inherit'});
+        } catch (e2) {
+          try {
+            execSync('stty echo', {stdio: 'inherit'});
+            execSync('stty icanon', {stdio: 'inherit'});
+          } catch (e3) {
+            // Ignore - best effort
+          }
+        }
+      }
+    }
+
+    process.exit(code || 0);
+  };
+
+  // Handle SIGINT (Ctrl+C) and SIGTERM
+  const signalHandler = (signal) => {
+    // Forward signal to child process
+    if (claude && !claude.killed) {
+      claude.kill(signal);
+    }
+    // Don't exit immediately - wait for child to exit
+  };
+
+  process.on('SIGINT', signalHandler);
+  process.on('SIGTERM', signalHandler);
+
   // Handle process exit
   claude.on('close', (code) => {
+    // Remove signal handlers to avoid duplicate handling
+    process.removeListener('SIGINT', signalHandler);
+    process.removeListener('SIGTERM', signalHandler);
+
+    // Show project promotion message on exit
+    console.log('');
+    console.log('──────────────────────────────────────────');
+    console.log('Thanks for using \x1b[1mccconfig\x1b[0m!');
+    console.log('');
+    console.log('If you find this tool helpful, please consider:');
+    console.log('  ⭐ Star us on GitHub: https://github.com/Danielmelody/ccconfig');
+    console.log('  📢 Share with others who use Claude Code');
+    console.log('──────────────────────────────────────────');
+    console.log('');
+
     if (code !== 0 && code !== null) {
       console.error(`Claude Code exited with code ${code}`);
-      process.exit(code);
+      exitGracefully(code);
+    } else {
+      exitGracefully(0);
     }
-    process.exit(0);
   });
 
   claude.on('error', (err) => {
+    // Remove signal handlers
+    process.removeListener('SIGINT', signalHandler);
+    process.removeListener('SIGTERM', signalHandler);
+
     console.error(`Error starting Claude Code: ${err.message}`);
     console.error('');
     console.error('Please make sure Claude Code CLI is installed:');
     console.error('  npm install -g claude-code');
-    process.exit(1);
+    exitGracefully(1);
   });
 }
 
@@ -1452,14 +1567,15 @@ function startClaude(name, extraArgs = [], options = {}) {
  * Start Claude Code with specified profile (auto-approve mode)
  */
 function start(name, extraArgs = []) {
-  return startClaude(name, extraArgs, { safe: false });
+  return startClaude(name, extraArgs, {safe: false});
 }
 
 /**
- * Start Claude Code with specified profile (safe mode - requires permission confirmation)
+ * Start Claude Code with specified profile (safe mode - requires permission
+ * confirmation)
  */
 function safeStart(name, extraArgs = []) {
-  return startClaude(name, extraArgs, { safe: true });
+  return startClaude(name, extraArgs, {safe: true});
 }
 
 /**
@@ -1473,7 +1589,8 @@ function completion(shell) {
     console.error('To install:');
     console.error('  Bash:       ccconfig completion bash >> ~/.bashrc');
     console.error('  Zsh:        ccconfig completion zsh >> ~/.zshrc');
-    console.error('  Fish:       ccconfig completion fish > ~/.config/fish/completions/ccconfig.fish');
+    console.error(
+        '  Fish:       ccconfig completion fish > ~/.config/fish/completions/ccconfig.fish');
     console.error('  PowerShell: ccconfig completion pwsh >> $PROFILE');
     process.exit(1);
   }
@@ -1786,8 +1903,7 @@ function help() {
       '  -s, --show-secret                         Show full token in current command');
   console.log('');
   console.log('Notes:');
-  console.log(
-      '  • Two ways to start Claude Code:');
+  console.log('  • Two ways to start Claude Code:');
   console.log(
       '    - start:      Auto-approve mode (adds --dangerously-skip-permissions)');
   console.log(
@@ -1843,8 +1959,10 @@ async function main() {
     // - Extract flags that appear BEFORE the command
     // - Keep command and all arguments after it unchanged (for Claude)
     const preCommandArgs = commandIndex >= 0 ? args.slice(0, commandIndex) : [];
-    showSecret = preCommandArgs.includes('--show-secret') || preCommandArgs.includes('-s');
-    permanent = preCommandArgs.includes('--permanent') || preCommandArgs.includes('-p');
+    showSecret = preCommandArgs.includes('--show-secret') ||
+        preCommandArgs.includes('-s');
+    permanent =
+        preCommandArgs.includes('--permanent') || preCommandArgs.includes('-p');
 
     // Keep command and all arguments after it (these go to Claude)
     filteredArgs = commandIndex >= 0 ? args.slice(commandIndex) : [];
@@ -1856,16 +1974,10 @@ async function main() {
     permanent = args.includes('--permanent') || args.includes('-p');
 
     // Filter out all recognized flags
-    filteredArgs = args.filter(arg =>
-      arg !== '--show-secret' &&
-      arg !== '-s' &&
-      arg !== '--permanent' &&
-      arg !== '-p' &&
-      arg !== '--version' &&
-      arg !== '-V' &&
-      arg !== '--help' &&
-      arg !== '-h'
-    );
+    filteredArgs = args.filter(
+        arg => arg !== '--show-secret' && arg !== '-s' &&
+            arg !== '--permanent' && arg !== '-p' && arg !== '--version' &&
+            arg !== '-V' && arg !== '--help' && arg !== '-h');
   }
 
   switch (command) {

package/package.json

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