@kaitranntt/ccs 4.2.0 → 4.3.1

package/VERSION

@@ -1 +1 @@
-4.2.0
+4.3.1

package/bin/ccs.js

@@ -271,17 +271,27 @@ async function handleDoctorCommand() {
 }
 
 async function handleSyncCommand() {
+  const { colored } = require('./utils/helpers');
+
+  console.log('');
+  console.log(colored('Syncing CCS Components...', 'cyan'));
+  console.log('');
+
   // First, copy .claude/ directory from package to ~/.ccs/.claude/
   const ClaudeDirInstaller = require('./utils/claude-dir-installer');
   const installer = new ClaudeDirInstaller();
   installer.install();
 
+  console.log('');
+
   // Then, create symlinks from ~/.ccs/.claude/ to ~/.claude/
   const ClaudeSymlinkManager = require('./utils/claude-symlink-manager');
   const manager = new ClaudeSymlinkManager();
+  manager.install(false);
 
-  console.log('[i] Syncing delegation commands and skills to ~/.claude/...');
-  manager.sync();
+  console.log('');
+  console.log(colored('[OK] Sync complete!', 'green'));
+  console.log('');
 
   process.exit(0);
 }

package/bin/management/doctor.js

@@ -6,6 +6,8 @@ const os = require('os');
 const { spawn } = require('child_process');
 const { colored } = require('../utils/helpers');
 const { detectClaudeCli } = require('../utils/claude-detector');
+const ora = require('ora');
+const Table = require('cli-table3');
 
 /**
  * Health check results
@@ -15,13 +17,19 @@ class HealthCheck {
     this.checks = [];
     this.warnings = [];
     this.errors = [];
+    this.details = {}; // Store detailed information for summary table
   }
 
-  addCheck(name, status, message = '', fix = null) {
+  addCheck(name, status, message = '', fix = null, details = null) {
     this.checks.push({ name, status, message, fix });
 
     if (status === 'error') this.errors.push({ name, message, fix });
     if (status === 'warning') this.warnings.push({ name, message, fix });
+
+    // Store details for summary table
+    if (details) {
+      this.details[name] = details;
+    }
   }
 
   hasErrors() {
@@ -46,6 +54,13 @@ class Doctor {
     this.ccsDir = path.join(this.homedir, '.ccs');
     this.claudeDir = path.join(this.homedir, '.claude');
     this.results = new HealthCheck();
+
+    // Get CCS version
+    try {
+      this.ccsVersion = require('../../package.json').version;
+    } catch (e) {
+      this.ccsVersion = 'unknown';
+    }
   }
 
   /**
@@ -55,15 +70,33 @@ class Doctor {
     console.log(colored('Running CCS Health Check...', 'cyan'));
     console.log('');
 
+    // Store CCS version in details
+    this.results.details['CCS Version'] = { status: 'OK', info: `v${this.ccsVersion}` };
+
+    // Group 1: System
+    console.log(colored('System:', 'bold'));
     await this.checkClaudeCli();
     this.checkCcsDirectory();
+    console.log('');
+
+    // Group 2: Configuration
+    console.log(colored('Configuration:', 'bold'));
     this.checkConfigFiles();
     this.checkClaudeSettings();
+    console.log('');
+
+    // Group 3: Profiles & Delegation
+    console.log(colored('Profiles & Delegation:', 'bold'));
     this.checkProfiles();
     this.checkInstances();
     this.checkDelegation();
+    console.log('');
+
+    // Group 4: System Health
+    console.log(colored('System Health:', 'bold'));
     this.checkPermissions();
     this.checkCcsSymlinks();
+    console.log('');
 
     this.showReport();
     return this.results;
@@ -73,7 +106,7 @@ class Doctor {
    * Check 1: Claude CLI availability
    */
   async checkClaudeCli() {
-    process.stdout.write('[?] Checking Claude CLI... ');
+    const spinner = ora('Checking Claude CLI').start();
 
     const claudeCli = detectClaudeCli();
 
@@ -97,15 +130,23 @@ class Doctor {
         child.on('error', reject);
       });
 
-      console.log(colored('[OK]', 'green'));
-      this.results.addCheck('Claude CLI', 'success', `Found: ${claudeCli}`);
+      // Extract version from output
+      const versionMatch = result.match(/(\d+\.\d+\.\d+)/);
+      const version = versionMatch ? versionMatch[1] : 'unknown';
+
+      spinner.succeed(`  ${'Claude CLI'.padEnd(26)}${colored('[OK]', 'green')}  ${claudeCli} (v${version})`);
+      this.results.addCheck('Claude CLI', 'success', `Found: ${claudeCli}`, null, {
+        status: 'OK',
+        info: `v${version} (${claudeCli})`
+      });
     } catch (err) {
-      console.log(colored('[X]', 'red'));
+      spinner.fail(`  ${'Claude CLI'.padEnd(26)}${colored('[X]', 'red')}  Not found or not working`);
       this.results.addCheck(
         'Claude CLI',
         'error',
         'Claude CLI not found or not working',
-        'Install from: https://docs.claude.com/en/docs/claude-code/installation'
+        'Install from: https://docs.claude.com/en/docs/claude-code/installation',
+        { status: 'ERROR', info: 'Not installed' }
       );
     }
   }
@@ -114,18 +155,22 @@ class Doctor {
    * Check 2: ~/.ccs/ directory
    */
   checkCcsDirectory() {
-    process.stdout.write('[?] Checking ~/.ccs/ directory... ');
+    const spinner = ora('Checking ~/.ccs/ directory').start();
 
     if (fs.existsSync(this.ccsDir)) {
-      console.log(colored('[OK]', 'green'));
-      this.results.addCheck('CCS Directory', 'success');
+      spinner.succeed(`  ${'CCS Directory'.padEnd(26)}${colored('[OK]', 'green')}  ~/.ccs/`);
+      this.results.addCheck('CCS Directory', 'success', null, null, {
+        status: 'OK',
+        info: '~/.ccs/'
+      });
     } else {
-      console.log(colored('[X]', 'red'));
+      spinner.fail(`  ${'CCS Directory'.padEnd(26)}${colored('[X]', 'red')}  Not found`);
       this.results.addCheck(
         'CCS Directory',
         'error',
         '~/.ccs/ directory not found',
-        'Run: npm install -g @kaitranntt/ccs --force'
+        'Run: npm install -g @kaitranntt/ccs --force',
+        { status: 'ERROR', info: 'Not found' }
       );
     }
   }
@@ -135,21 +180,24 @@ class Doctor {
    */
   checkConfigFiles() {
     const files = [
-      { path: path.join(this.ccsDir, 'config.json'), name: 'config.json' },
-      { path: path.join(this.ccsDir, 'glm.settings.json'), name: 'glm.settings.json' },
-      { path: path.join(this.ccsDir, 'kimi.settings.json'), name: 'kimi.settings.json' }
+      { path: path.join(this.ccsDir, 'config.json'), name: 'config.json', key: 'config.json' },
+      { path: path.join(this.ccsDir, 'glm.settings.json'), name: 'glm.settings.json', key: 'GLM Settings', profile: 'glm' },
+      { path: path.join(this.ccsDir, 'kimi.settings.json'), name: 'kimi.settings.json', key: 'Kimi Settings', profile: 'kimi' }
     ];
 
+    const { DelegationValidator } = require('../utils/delegation-validator');
+
     for (const file of files) {
-      process.stdout.write(`[?] Checking ${file.name}... `);
+      const spinner = ora(`Checking ${file.name}`).start();
 
       if (!fs.existsSync(file.path)) {
-        console.log(colored('[X]', 'red'));
+        spinner.fail(`  ${file.name.padEnd(26)}${colored('[X]', 'red')}  Not found`);
         this.results.addCheck(
           file.name,
           'error',
           `${file.name} not found`,
-          'Run: npm install -g @kaitranntt/ccs --force'
+          'Run: npm install -g @kaitranntt/ccs --force',
+          { status: 'ERROR', info: 'Not found' }
         );
         continue;
       }
@@ -157,16 +205,48 @@ class Doctor {
       // Validate JSON
       try {
         const content = fs.readFileSync(file.path, 'utf8');
-        JSON.parse(content);
-        console.log(colored('[OK]', 'green'));
-        this.results.addCheck(file.name, 'success');
+        const config = JSON.parse(content);
+
+        // Extract useful info based on file type
+        let info = 'Valid';
+        let status = 'OK';
+
+        if (file.profile) {
+          // For settings files, check if API key is configured
+          const validation = DelegationValidator.validate(file.profile);
+
+          if (validation.valid) {
+            info = 'Key configured';
+            status = 'OK';
+          } else if (validation.error && validation.error.includes('placeholder')) {
+            info = 'Placeholder key (not configured)';
+            status = 'WARN';
+          } else {
+            info = 'Valid JSON';
+            status = 'OK';
+          }
+        }
+
+        const statusIcon = status === 'OK' ? colored('[OK]', 'green') : colored('[!]', 'yellow');
+
+        if (status === 'WARN') {
+          spinner.warn(`  ${file.name.padEnd(26)}${statusIcon}  ${info}`);
+        } else {
+          spinner.succeed(`  ${file.name.padEnd(26)}${statusIcon}  ${info}`);
+        }
+
+        this.results.addCheck(file.name, status === 'OK' ? 'success' : 'warning', null, null, {
+          status: status,
+          info: info
+        });
       } catch (e) {
-        console.log(colored('[X]', 'red'));
+        spinner.fail(`  ${file.name.padEnd(26)}${colored('[X]', 'red')}  Invalid JSON`);
         this.results.addCheck(
           file.name,
           'error',
           `Invalid JSON: ${e.message}`,
-          `Backup and recreate: mv ${file.path} ${file.path}.backup && npm install -g @kaitranntt/ccs --force`
+          `Backup and recreate: mv ${file.path} ${file.path}.backup && npm install -g @kaitranntt/ccs --force`,
+          { status: 'ERROR', info: 'Invalid JSON' }
         );
       }
     }
@@ -176,12 +256,11 @@ class Doctor {
    * Check 4: Claude settings
    */
   checkClaudeSettings() {
-    process.stdout.write('[?] Checking ~/.claude/settings.json... ');
-
+    const spinner = ora('Checking ~/.claude/settings.json').start();
     const settingsPath = path.join(this.claudeDir, 'settings.json');
 
     if (!fs.existsSync(settingsPath)) {
-      console.log(colored('[!]', 'yellow'));
+      spinner.warn(`  ${'~/.claude/settings.json'.padEnd(26)}${colored('[!]', 'yellow')}  Not found`);
       this.results.addCheck(
         'Claude Settings',
         'warning',
@@ -195,10 +274,10 @@ class Doctor {
     try {
       const content = fs.readFileSync(settingsPath, 'utf8');
       JSON.parse(content);
-      console.log(colored('[OK]', 'green'));
+      spinner.succeed(`  ${'~/.claude/settings.json'.padEnd(26)}${colored('[OK]', 'green')}`);
       this.results.addCheck('Claude Settings', 'success');
     } catch (e) {
-      console.log(colored('[!]', 'yellow'));
+      spinner.warn(`  ${'~/.claude/settings.json'.padEnd(26)}${colored('[!]', 'yellow')}  Invalid JSON`);
       this.results.addCheck(
         'Claude Settings',
         'warning',
@@ -212,11 +291,11 @@ class Doctor {
    * Check 5: Profile configurations
    */
   checkProfiles() {
-    process.stdout.write('[?] Checking profiles... ');
-
+    const spinner = ora('Checking profiles').start();
     const configPath = path.join(this.ccsDir, 'config.json');
+
     if (!fs.existsSync(configPath)) {
-      console.log(colored('[SKIP]', 'yellow'));
+      spinner.info(`  ${'Profiles'.padEnd(26)}${colored('[SKIP]', 'cyan')}  config.json not found`);
       return;
     }
 
@@ -224,22 +303,31 @@ class Doctor {
       const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
 
       if (!config.profiles || typeof config.profiles !== 'object') {
-        console.log(colored('[X]', 'red'));
+        spinner.fail(`  ${'Profiles'.padEnd(26)}${colored('[X]', 'red')}  Missing profiles object`);
         this.results.addCheck(
           'Profiles',
           'error',
           'config.json missing profiles object',
-          'Run: npm install -g @kaitranntt/ccs --force'
+          'Run: npm install -g @kaitranntt/ccs --force',
+          { status: 'ERROR', info: 'Missing profiles object' }
         );
         return;
       }
 
       const profileCount = Object.keys(config.profiles).length;
-      console.log(colored('[OK]', 'green'), `(${profileCount} profiles)`);
-      this.results.addCheck('Profiles', 'success', `${profileCount} profiles configured`);
+      const profileNames = Object.keys(config.profiles).join(', ');
+
+      spinner.succeed(`  ${'Profiles'.padEnd(26)}${colored('[OK]', 'green')}  ${profileCount} configured (${profileNames})`);
+      this.results.addCheck('Profiles', 'success', `${profileCount} profiles configured`, null, {
+        status: 'OK',
+        info: `${profileCount} configured (${profileNames.length > 30 ? profileNames.substring(0, 27) + '...' : profileNames})`
+      });
     } catch (e) {
-      console.log(colored('[X]', 'red'));
-      this.results.addCheck('Profiles', 'error', e.message);
+      spinner.fail(`  ${'Profiles'.padEnd(26)}${colored('[X]', 'red')}  ${e.message}`);
+      this.results.addCheck('Profiles', 'error', e.message, null, {
+        status: 'ERROR',
+        info: e.message
+      });
     }
   }
 
@@ -247,11 +335,11 @@ class Doctor {
    * Check 6: Instance directories (account-based profiles)
    */
   checkInstances() {
-    process.stdout.write('[?] Checking instances... ');
-
+    const spinner = ora('Checking instances').start();
     const instancesDir = path.join(this.ccsDir, 'instances');
+
     if (!fs.existsSync(instancesDir)) {
-      console.log(colored('[i]', 'cyan'), '(no account profiles)');
+      spinner.info(`  ${'Instances'.padEnd(26)}${colored('[i]', 'cyan')}  No account profiles`);
       this.results.addCheck('Instances', 'success', 'No account profiles configured');
       return;
     }
@@ -261,12 +349,12 @@ class Doctor {
     });
 
     if (instances.length === 0) {
-      console.log(colored('[i]', 'cyan'), '(no account profiles)');
+      spinner.info(`  ${'Instances'.padEnd(26)}${colored('[i]', 'cyan')}  No account profiles`);
       this.results.addCheck('Instances', 'success', 'No account profiles');
       return;
     }
 
-    console.log(colored('[OK]', 'green'), `(${instances.length} instances)`);
+    spinner.succeed(`  ${'Instances'.padEnd(26)}${colored('[OK]', 'green')}  ${instances.length} account profiles`);
     this.results.addCheck('Instances', 'success', `${instances.length} account profiles`);
   }
 
@@ -274,7 +362,7 @@ class Doctor {
    * Check 7: Delegation system
    */
   checkDelegation() {
-    process.stdout.write('[?] Checking delegation... ');
+    const spinner = ora('Checking delegation').start();
 
     // Check if delegation commands exist in ~/.ccs/.claude/commands/ccs/
     const ccsClaudeCommandsDir = path.join(this.ccsDir, '.claude', 'commands', 'ccs');
@@ -282,12 +370,13 @@ class Doctor {
     const hasKimiCommand = fs.existsSync(path.join(ccsClaudeCommandsDir, 'kimi.md'));
 
     if (!hasGlmCommand || !hasKimiCommand) {
-      console.log(colored('[!]', 'yellow'), '(not installed)');
+      spinner.warn(`  ${'Delegation'.padEnd(26)}${colored('[!]', 'yellow')}  Not installed`);
       this.results.addCheck(
         'Delegation',
         'warning',
         'Delegation commands not found',
-        'Install with: npm install -g @kaitranntt/ccs --force'
+        'Install with: npm install -g @kaitranntt/ccs --force',
+        { status: 'WARN', info: 'Not installed' }
       );
       return;
     }
@@ -304,21 +393,24 @@ class Doctor {
     }
 
     if (readyProfiles.length === 0) {
-      console.log(colored('[!]', 'yellow'), '(no profiles ready)');
+      spinner.warn(`  ${'Delegation'.padEnd(26)}${colored('[!]', 'yellow')}  No profiles ready`);
       this.results.addCheck(
         'Delegation',
         'warning',
         'Delegation installed but no profiles configured',
-        'Configure profiles with valid API keys (not placeholders)'
+        'Configure profiles with valid API keys (not placeholders)',
+        { status: 'WARN', info: 'No profiles ready' }
       );
       return;
     }
 
-    console.log(colored('[OK]', 'green'), `(${readyProfiles.join(', ')} ready)`);
+    spinner.succeed(`  ${'Delegation'.padEnd(26)}${colored('[OK]', 'green')}  ${readyProfiles.length} profiles ready (${readyProfiles.join(', ')})`);
     this.results.addCheck(
       'Delegation',
       'success',
-      `${readyProfiles.length} profile(s) ready: ${readyProfiles.join(', ')}`
+      `${readyProfiles.length} profile(s) ready: ${readyProfiles.join(', ')}`,
+      null,
+      { status: 'OK', info: `${readyProfiles.length} profiles ready` }
     );
   }
 
@@ -326,22 +418,25 @@ class Doctor {
    * Check 8: File permissions
    */
   checkPermissions() {
-    process.stdout.write('[?] Checking permissions... ');
-
+    const spinner = ora('Checking permissions').start();
     const testFile = path.join(this.ccsDir, '.permission-test');
 
     try {
       fs.writeFileSync(testFile, 'test', 'utf8');
       fs.unlinkSync(testFile);
-      console.log(colored('[OK]', 'green'));
-      this.results.addCheck('Permissions', 'success');
+      spinner.succeed(`  ${'Permissions'.padEnd(26)}${colored('[OK]', 'green')}  Write access verified`);
+      this.results.addCheck('Permissions', 'success', null, null, {
+        status: 'OK',
+        info: 'Write access verified'
+      });
     } catch (e) {
-      console.log(colored('[X]', 'red'));
+      spinner.fail(`  ${'Permissions'.padEnd(26)}${colored('[X]', 'red')}  Cannot write to ~/.ccs/`);
       this.results.addCheck(
         'Permissions',
         'error',
         'Cannot write to ~/.ccs/',
-        'Fix: sudo chown -R $USER ~/.ccs ~/.claude && chmod 755 ~/.ccs ~/.claude'
+        'Fix: sudo chown -R $USER ~/.ccs ~/.claude && chmod 755 ~/.ccs ~/.claude',
+        { status: 'ERROR', info: 'Cannot write to ~/.ccs/' }
       );
     }
   }
@@ -350,7 +445,7 @@ class Doctor {
    * Check 9: CCS symlinks to ~/.claude/
    */
   checkCcsSymlinks() {
-    process.stdout.write('[?] Checking CCS symlinks... ');
+    const spinner = ora('Checking CCS symlinks').start();
 
     try {
       const ClaudeSymlinkManager = require('../utils/claude-symlink-manager');
@@ -358,24 +453,30 @@ class Doctor {
       const health = manager.checkHealth();
 
       if (health.healthy) {
-        console.log(colored('[OK]', 'green'));
-        this.results.addCheck('CCS Symlinks', 'success', 'All CCS items properly symlinked');
+        const itemCount = manager.ccsItems.length;
+        spinner.succeed(`  ${'CCS Symlinks'.padEnd(26)}${colored('[OK]', 'green')}  ${itemCount}/${itemCount} items linked`);
+        this.results.addCheck('CCS Symlinks', 'success', 'All CCS items properly symlinked', null, {
+          status: 'OK',
+          info: `${itemCount}/${itemCount} items synced`
+        });
       } else {
-        console.log(colored('[!]', 'yellow'));
+        spinner.warn(`  ${'CCS Symlinks'.padEnd(26)}${colored('[!]', 'yellow')}  ${health.issues.length} issues found`);
         this.results.addCheck(
           'CCS Symlinks',
           'warning',
           health.issues.join(', '),
-          'Run: ccs sync'
+          'Run: ccs sync',
+          { status: 'WARN', info: `${health.issues.length} issues` }
         );
       }
     } catch (e) {
-      console.log(colored('[!]', 'yellow'));
+      spinner.warn(`  ${'CCS Symlinks'.padEnd(26)}${colored('[!]', 'yellow')}  Could not check`);
       this.results.addCheck(
         'CCS Symlinks',
         'warning',
         'Could not check CCS symlinks: ' + e.message,
-        'Run: ccs sync'
+        'Run: ccs sync',
+        { status: 'WARN', info: 'Could not check' }
       );
     }
   }
@@ -385,20 +486,43 @@ class Doctor {
    */
   showReport() {
     console.log('');
-    console.log(colored('═══════════════════════════════════════════', 'cyan'));
-    console.log(colored('Health Check Report', 'bold'));
-    console.log(colored('═══════════════════════════════════════════', 'cyan'));
-    console.log('');
 
-    if (this.results.isHealthy() && !this.results.hasWarnings()) {
-      console.log(colored('✓ All checks passed!', 'green'));
-      console.log('');
-      console.log('Your CCS installation is healthy.');
-      console.log('');
-      return;
+    // Calculate exact table width to match header bars
+    // colWidths: [20, 10, 35] = 65 + borders (4) = 69 total
+    const tableWidth = 69;
+    const headerBar = '═'.repeat(tableWidth);
+
+    console.log(colored(headerBar, 'cyan'));
+    console.log(colored('                     Health Check Summary', 'bold'));
+    console.log(colored(headerBar, 'cyan'));
+
+    // Create summary table with detailed information
+    const table = new Table({
+      head: [colored('Component', 'cyan'), colored('Status', 'cyan'), colored('Details', 'cyan')],
+      colWidths: [20, 10, 35],
+      wordWrap: true,
+      chars: {
+        'top': '═', 'top-mid': '╤', 'top-left': '╔', 'top-right': '╗',
+        'bottom': '═', 'bottom-mid': '╧', 'bottom-left': '╚', 'bottom-right': '╝',
+        'left': '║', 'left-mid': '╟', 'mid': '─', 'mid-mid': '┼',
+        'right': '║', 'right-mid': '╢', 'middle': '│'
+      }
+    });
+
+    // Populate table with collected details
+    for (const [component, detail] of Object.entries(this.results.details)) {
+      const statusColor = detail.status === 'OK' ? 'green' : detail.status === 'ERROR' ? 'red' : 'yellow';
+      table.push([
+        component,
+        colored(detail.status, statusColor),
+        detail.info || ''
+      ]);
     }
 
-    // Show errors
+    console.log(table.toString());
+    console.log('');
+
+    // Show errors and warnings if present
     if (this.results.hasErrors()) {
       console.log(colored('Errors:', 'red'));
       this.results.errors.forEach(err => {
@@ -410,7 +534,6 @@ class Doctor {
       console.log('');
     }
 
-    // Show warnings
     if (this.results.hasWarnings()) {
       console.log(colored('Warnings:', 'yellow'));
       this.results.warnings.forEach(warn => {
@@ -422,12 +545,14 @@ class Doctor {
       console.log('');
     }
 
-    // Summary
-    if (this.results.hasErrors()) {
-      console.log(colored('Status: Installation has errors', 'red'));
+    // Final status
+    if (this.results.isHealthy() && !this.results.hasWarnings()) {
+      console.log(colored('[OK] All checks passed! Your CCS installation is healthy.', 'green'));
+    } else if (this.results.hasErrors()) {
+      console.log(colored('[X] Status: Installation has errors', 'red'));
       console.log('Run suggested fixes above to resolve issues.');
     } else {
-      console.log(colored('Status: Installation healthy (warnings only)', 'green'));
+      console.log(colored('[OK] Status: Installation healthy (warnings only)', 'green'));
     }
 
     console.log('');

package/bin/utils/claude-dir-installer.js

@@ -4,6 +4,8 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const ora = require('ora');
+const { colored } = require('./helpers');
 
 /**
  * ClaudeDirInstaller - Manages copying .claude/ directory from package to ~/.ccs/.claude/
@@ -18,8 +20,11 @@ class ClaudeDirInstaller {
   /**
    * Copy .claude/ directory from package to ~/.ccs/.claude/
    * @param {string} packageDir - Package installation directory (default: auto-detect)
+   * @param {boolean} silent - Suppress spinner output
    */
-  install(packageDir) {
+  install(packageDir, silent = false) {
+    const spinner = silent ? null : ora('Copying .claude/ items to ~/.ccs/.claude/').start();
+
     try {
       // Auto-detect package directory if not provided
       if (!packageDir) {
@@ -30,21 +35,29 @@ class ClaudeDirInstaller {
       const packageClaudeDir = path.join(packageDir, '.claude');
 
       if (!fs.existsSync(packageClaudeDir)) {
-        console.log('[!] Package .claude/ directory not found');
-        console.log(`    Searched in: ${packageClaudeDir}`);
-        console.log('    This may be a development installation');
+        const msg = 'Package .claude/ directory not found';
+        if (spinner) {
+          spinner.warn(`[!] ${msg}`);
+          console.log(`    Searched in: ${packageClaudeDir}`);
+          console.log('    This may be a development installation');
+        } else {
+          console.log(`[!] ${msg}`);
+          console.log(`    Searched in: ${packageClaudeDir}`);
+          console.log('    This may be a development installation');
+        }
         return false;
       }
 
-      console.log('[i] Installing CCS .claude/ items...');
-
       // Remove old version before copying new one
       if (fs.existsSync(this.ccsClaudeDir)) {
+        if (spinner) spinner.text = 'Removing old .claude/ items...';
         fs.rmSync(this.ccsClaudeDir, { recursive: true, force: true });
       }
 
       // Use fs.cpSync for recursive copy (Node.js 16.7.0+)
       // Fallback to manual copy for older Node.js versions
+      if (spinner) spinner.text = 'Copying .claude/ items...';
+
       if (fs.cpSync) {
         fs.cpSync(packageClaudeDir, this.ccsClaudeDir, { recursive: true });
       } else {
@@ -52,11 +65,25 @@ class ClaudeDirInstaller {
         this._copyDirRecursive(packageClaudeDir, this.ccsClaudeDir);
       }
 
-      console.log('[OK] Copied .claude/ items to ~/.ccs/.claude/');
+      // Count files and directories
+      const itemCount = this._countItems(this.ccsClaudeDir);
+      const msg = `Copied .claude/ items (${itemCount.files} files, ${itemCount.dirs} directories)`;
+
+      if (spinner) {
+        spinner.succeed(colored('[OK]', 'green') + ` ${msg}`);
+      } else {
+        console.log(`[OK] ${msg}`);
+      }
       return true;
     } catch (err) {
-      console.warn('[!] Failed to copy .claude/ directory:', err.message);
-      console.warn('    CCS items may not be available');
+      const msg = `Failed to copy .claude/ directory: ${err.message}`;
+      if (spinner) {
+        spinner.fail(colored('[!]', 'yellow') + ` ${msg}`);
+        console.warn('    CCS items may not be available');
+      } else {
+        console.warn(`[!] ${msg}`);
+        console.warn('    CCS items may not be available');
+      }
       return false;
     }
   }
@@ -90,6 +117,37 @@ class ClaudeDirInstaller {
     }
   }
 
+  /**
+   * Count files and directories in a path
+   * @param {string} dirPath - Directory to count
+   * @returns {Object} { files: number, dirs: number }
+   * @private
+   */
+  _countItems(dirPath) {
+    let files = 0;
+    let dirs = 0;
+
+    const countRecursive = (p) => {
+      const entries = fs.readdirSync(p, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          dirs++;
+          countRecursive(path.join(p, entry.name));
+        } else {
+          files++;
+        }
+      }
+    };
+
+    try {
+      countRecursive(dirPath);
+    } catch (e) {
+      // Ignore errors
+    }
+
+    return { files, dirs };
+  }
+
   /**
    * Check if ~/.ccs/.claude/ exists and is valid
    * @returns {boolean} True if directory exists

package/bin/utils/claude-symlink-manager.js

@@ -3,6 +3,8 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const ora = require('ora');
+const { colored } = require('./helpers');
 
 /**
  * ClaudeSymlinkManager - Manages selective symlinks from ~/.ccs/.claude/ to ~/.claude/
@@ -35,41 +37,62 @@ class ClaudeSymlinkManager {
    * Install CCS items to user's ~/.claude/ via selective symlinks
    * Safe: backs up existing files before creating symlinks
    */
-  install() {
+  install(silent = false) {
+    const spinner = silent ? null : ora('Installing CCS items to ~/.claude/').start();
+
     // Ensure ~/.ccs/.claude/ exists (should be shipped with package)
     if (!fs.existsSync(this.ccsClaudeDir)) {
-      console.log('[!] CCS .claude/ directory not found, skipping symlink installation');
+      const msg = 'CCS .claude/ directory not found, skipping symlink installation';
+      if (spinner) {
+        spinner.warn(`[!] ${msg}`);
+      } else {
+        console.log(`[!] ${msg}`);
+      }
       return;
     }
 
     // Create ~/.claude/ if missing
     if (!fs.existsSync(this.userClaudeDir)) {
-      console.log('[i] Creating ~/.claude/ directory');
+      if (!silent) {
+        if (spinner) spinner.text = 'Creating ~/.claude/ directory';
+      }
       fs.mkdirSync(this.userClaudeDir, { recursive: true, mode: 0o700 });
     }
 
     // Install each CCS item
+    let installed = 0;
     for (const item of this.ccsItems) {
-      this._installItem(item);
+      if (!silent && spinner) {
+        spinner.text = `Installing ${item.target}...`;
+      }
+      const result = this._installItem(item, silent);
+      if (result) installed++;
     }
 
-    console.log('[OK] Delegation commands and skills installed to ~/.claude/');
+    const msg = `${installed}/${this.ccsItems.length} items installed to ~/.claude/`;
+    if (spinner) {
+      spinner.succeed(colored('[OK]', 'green') + ` ${msg}`);
+    } else {
+      console.log(`[OK] ${msg}`);
+    }
   }
 
   /**
    * Install a single CCS item with conflict handling
    * @param {Object} item - Item descriptor {source, target, type}
+   * @param {boolean} silent - Suppress individual item messages
+   * @returns {boolean} True if installed successfully
    * @private
    */
-  _installItem(item) {
+  _installItem(item, silent = false) {
     const sourcePath = path.join(this.ccsClaudeDir, item.source);
     const targetPath = path.join(this.userClaudeDir, item.target);
     const targetDir = path.dirname(targetPath);
 
     // Ensure source exists
     if (!fs.existsSync(sourcePath)) {
-      console.log(`[!] Source not found: ${item.source}, skipping`);
-      return;
+      if (!silent) console.log(`[!] Source not found: ${item.source}, skipping`);
+      return false;
     }
 
     // Create target parent directory if needed
@@ -81,26 +104,30 @@ class ClaudeSymlinkManager {
     if (fs.existsSync(targetPath)) {
       // Check if it's already the correct symlink
       if (this._isOurSymlink(targetPath, sourcePath)) {
-        return; // Already correct, skip
+        return true; // Already correct, counts as success
       }
 
       // Backup existing file/directory
-      this._backupItem(targetPath);
+      this._backupItem(targetPath, silent);
     }
 
     // Create symlink
     try {
       const symlinkType = item.type === 'directory' ? 'dir' : 'file';
       fs.symlinkSync(sourcePath, targetPath, symlinkType);
-      console.log(`[OK] Symlinked ${item.target}`);
+      if (!silent) console.log(`[OK] Symlinked ${item.target}`);
+      return true;
     } catch (err) {
       // Windows fallback: stub for now, full implementation in v4.2
       if (process.platform === 'win32') {
-        console.log(`[!] Symlink failed for ${item.target} (Windows fallback deferred to v4.2)`);
-        console.log(`[i] Enable Developer Mode or wait for next update`);
+        if (!silent) {
+          console.log(`[!] Symlink failed for ${item.target} (Windows fallback deferred to v4.2)`);
+          console.log(`[i] Enable Developer Mode or wait for next update`);
+        }
       } else {
-        console.log(`[!] Failed to symlink ${item.target}: ${err.message}`);
+        if (!silent) console.log(`[!] Failed to symlink ${item.target}: ${err.message}`);
       }
+      return false;
     }
   }
 
@@ -131,9 +158,10 @@ class ClaudeSymlinkManager {
   /**
    * Backup existing item before replacing with symlink
    * @param {string} itemPath - Path to item to backup
+   * @param {boolean} silent - Suppress backup messages
    * @private
    */
-  _backupItem(itemPath) {
+  _backupItem(itemPath, silent = false) {
     const timestamp = new Date().toISOString().replace(/[:.]/g, '-').split('T')[0];
     const backupPath = `${itemPath}.backup-${timestamp}`;
 
@@ -147,9 +175,9 @@ class ClaudeSymlinkManager {
       }
 
       fs.renameSync(itemPath, finalBackupPath);
-      console.log(`[i] Backed up existing item to ${path.basename(finalBackupPath)}`);
+      if (!silent) console.log(`[i] Backed up existing item to ${path.basename(finalBackupPath)}`);
     } catch (err) {
-      console.log(`[!] Failed to backup ${itemPath}: ${err.message}`);
+      if (!silent) console.log(`[!] Failed to backup ${itemPath}: ${err.message}`);
       throw err; // Don't proceed if backup fails
     }
   }
@@ -230,8 +258,10 @@ class ClaudeSymlinkManager {
    * Same as install() but with explicit sync message
    */
   sync() {
-    console.log('[i] Syncing delegation commands and skills to ~/.claude/...');
-    this.install();
+    console.log('');
+    console.log(colored('Syncing CCS Components...', 'cyan'));
+    console.log('');
+    this.install(false);
   }
 }
 

package/lib/ccs

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 # Version (updated by scripts/bump-version.sh)
-CCS_VERSION="4.2.0"
+CCS_VERSION="4.3.1"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 readonly CONFIG_FILE="${CCS_CONFIG:-$HOME/.ccs/config.json}"
 readonly PROFILES_JSON="$HOME/.ccs/profiles.json"

package/lib/ccs.ps1

@@ -12,7 +12,7 @@ param(
 $ErrorActionPreference = "Stop"
 
 # Version (updated by scripts/bump-version.sh)
-$CcsVersion = "4.2.0"
+$CcsVersion = "4.3.1"
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 $ConfigFile = if ($env:CCS_CONFIG) { $env:CCS_CONFIG } else { "$env:USERPROFILE\.ccs\config.json" }
 $ProfilesJson = "$env:USERPROFILE\.ccs\profiles.json"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaitranntt/ccs",
-  "version": "4.2.0",
+  "version": "4.3.1",
   "description": "Claude Code Switch - Instant profile switching between Claude Sonnet 4.5 and GLM 4.6",
   "keywords": [
     "cli",
@@ -57,6 +57,10 @@
     "prepare": "node scripts/check-executables.js",
     "postinstall": "node scripts/postinstall.js"
   },
+  "dependencies": {
+    "cli-table3": "^0.6.5",
+    "ora": "^5.4.1"
+  },
   "devDependencies": {
     "mocha": "^11.7.5"
   }

package/scripts/completion/ccs.fish

@@ -1,6 +1,11 @@
 # Fish completion for CCS (Claude Code Switch)
 # Compatible with fish 3.0+
 #
+# Features:
+#   - Categorized completions with [cmd], [model], and [account] prefixes
+#   - Dynamic profile loading from config.json and profiles.json
+#   - Context-aware subcommand completion
+#
 # Installation:
 #   Copy to ~/.config/fish/completions/:
 #     mkdir -p ~/.config/fish/completions
@@ -72,23 +77,23 @@ complete -c ccs -s h -l help -d 'Show help message'
 complete -c ccs -s v -l version -d 'Show version information'
 complete -c ccs -s sc -l shell-completion -d 'Install shell completion'
 
-# Top-level commands (blue color for commands)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'auth' -d (set_color blue)'Manage multiple Claude accounts'(set_color normal)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'doctor' -d (set_color blue)'Run health check and diagnostics'(set_color normal)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'sync' -d (set_color blue)'Sync delegation commands and skills'(set_color normal)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'update' -d (set_color blue)'Update CCS to latest version'(set_color normal)
+# Commands - grouped with [cmd] prefix for visual distinction
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'auth' -d '[cmd] Manage multiple Claude accounts'
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'doctor' -d '[cmd] Run health check and diagnostics'
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'sync' -d '[cmd] Sync delegation commands and skills'
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'update' -d '[cmd] Update CCS to latest version'
 
-# Top-level known settings profiles (green color for model profiles)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'default' -d (set_color green)'Default Claude Sonnet 4.5'(set_color normal)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'glm' -d (set_color green)'GLM-4.6 (cost-optimized)'(set_color normal)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'glmt' -d (set_color green)'GLM-4.6 with thinking mode'(set_color normal)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'kimi' -d (set_color green)'Kimi for Coding (long-context)'(set_color normal)
+# Model profiles - grouped with [model] prefix for visual distinction
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'default' -d '[model] Default Claude Sonnet 4.5'
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'glm' -d '[model] GLM-4.6 (cost-optimized)'
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'glmt' -d '[model] GLM-4.6 with thinking mode'
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a 'kimi' -d '[model] Kimi for Coding (long-context)'
 
-# Top-level custom settings profiles (dynamic, with generic description in green)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a '(__fish_ccs_get_custom_settings_profiles)' -d (set_color green)'Settings-based profile'(set_color normal)
+# Custom model profiles - dynamic with [model] prefix
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a '(__fish_ccs_get_custom_settings_profiles)' -d '[model] Settings-based profile'
 
-# Top-level account profiles (dynamic, yellow color for account profiles)
-complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a '(__fish_ccs_get_account_profiles)' -d (set_color yellow)'Account profile'(set_color normal)
+# Account profiles - dynamic with [account] prefix
+complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor sync update' -a '(__fish_ccs_get_account_profiles)' -d '[account] Account-based profile'
 
 # shell-completion subflags
 complete -c ccs -n '__fish_seen_argument -l shell-completion; or __fish_seen_argument -s sc' -l bash -d 'Install for bash'