@kaitranntt/ccs 2.4.5 → 2.4.6

package/README.md

@@ -191,35 +191,6 @@ graph LR
 - **Context Preservation**: Your workflow remains uninterrupted
 - **Seamless Integration**: Works exactly like native Claude CLI
 
-### Task Delegation
-
-> **🚧 Work in Progress**: This feature is experimental and not fully tested. Use with caution.
-
-CCS includes intelligent task delegation via the `/ccs` meta-command:
-
-**Install CCS commands:**
-```bash
-ccs --install    # Install /ccs command to Claude CLI
-```
-
-**Use task delegation:**
-```bash
-# After running ccs --install, you can use:
-/ccs glm /plan "add user authentication"
-/ccs glm /code "implement auth endpoints"
-/ccs glm /ask "explain this error"
-```
-
-**Remove when not needed:**
-```bash
-ccs --uninstall  # Remove /ccs command from Claude CLI
-```
-
-**Benefits**:
-- ✅ Save tokens by delegating simple tasks to cheaper models
-- ✅ Use right model for each task automatically
-- ✅ Seamless integration with existing workflows
-- ✅ Clean installation and removal when needed
 
 ---
 
@@ -229,8 +200,6 @@ ccs --uninstall  # Remove /ccs command from Claude CLI
 ccs              # Use Claude subscription (default)
 ccs glm          # Use GLM fallback
 ccs --version    # Show CCS version and install location
-ccs --install    # Install CCS commands and skills to ~/.claude/
-ccs --uninstall  # Remove CCS commands and skills from ~/.claude/
 ```
 
 ---

package/README.vi.md

@@ -190,35 +190,6 @@ graph LR
 - **Bảo Toàn Context**: Workflow của bạn không bị gián đoạn
 - **Tích Hợp Liền Mạch**: Hoạt động chính xác như Claude CLI native
 
-### Delegation Tác Vụ
-
-> **🚧 Đang phát triển**: Tính năng này đang trong giai đoạn thử nghiệm và chưa được kiểm tra đầy đủ. Sử dụng với cẩn thận.
-
-CCS bao gồm delegation tác vụ thông minh qua meta-command `/ccs`:
-
-**Cài đặt lệnh CCS:**
-```bash
-ccs --install    # Cài đặt lệnh /ccs vào Claude CLI
-```
-
-**Sử dụng delegation tác vụ:**
-```bash
-# Sau khi chạy ccs --install, bạn có thể dùng:
-/ccs glm /plan "add user authentication"
-/ccs glm /code "implement auth endpoints"
-/ccs glm /ask "explain this error"
-```
-
-**Gỡ bỏ khi không cần:**
-```bash
-ccs --uninstall  # Gỡ bỏ lệnh /ccs khỏi Claude CLI
-```
-
-**Lợi ích**:
-- ✅ Tiết kiệm tokens bằng cách delegation tác vụ đơn giản cho model rẻ hơn
-- ✅ Dùng đúng model cho từng tác vụ tự động
-- ✅ Tích hợp liền mạch với workflows hiện có
-- ✅ Cài đặt và gỡ bỏ sạch sẽ khi cần
 
 ---
 
@@ -228,8 +199,6 @@ ccs --uninstall  # Gỡ bỏ lệnh /ccs khỏi Claude CLI
 ccs              # Dùng Claude subscription (mặc định)
 ccs glm          # Dùng GLM fallback
 ccs --version    # Hiển thị phiên bản CCS và vị trí cài đặt
-ccs --install    # Cài đặt lệnh và kỹ năng CCS vào ~/.claude/
-ccs --uninstall  # Gỡ bỏ lệnh và kỹ năng CCS khỏi ~/.claude/
 ```
 
 ---

package/VERSION

@@ -1 +1 @@
-2.4.5
+2.4.6

package/bin/ccs.js

@@ -4,9 +4,9 @@
 const { spawn } = require('child_process');
 const path = require('path');
 const fs = require('fs');
-const { error } = require('./helpers');
+const { error, colored } = require('./helpers');
 const { detectClaudeCli, showClaudeNotFoundError } = require('./claude-detector');
-const { getSettingsPath } = require('./config-manager');
+const { getSettingsPath, getConfigPath } = require('./config-manager');
 
 // Version (sync with package.json)
 const CCS_VERSION = require('../package.json').version;
@@ -26,42 +26,127 @@ function execClaude(claudeCli, args) {
 
 // Special command handlers
 function handleVersionCommand() {
-  console.log(`CCS (Claude Code Switch) version ${CCS_VERSION}`);
+  // Title
+  console.log(colored(`CCS (Claude Code Switch) v${CCS_VERSION}`, 'bold'));
+  console.log('');
 
-  // Show install location
-  const installLocation = process.argv[1];
-  if (installLocation) {
-    console.log(`Installed at: ${installLocation}`);
-  }
+  // Installation section
+  console.log(colored('Installation:', 'cyan'));
+
+  // Location
+  const installLocation = process.argv[1] || '(not found)';
+  console.log(`  ${colored('Location:', 'cyan')} ${installLocation}`);
+
+  // Config path
+  const configPath = getConfigPath();
+  console.log(`  ${colored('Config:', 'cyan')} ${configPath}`);
+  console.log('');
+
+  // Documentation
+  console.log(`${colored('Documentation:', 'cyan')} https://github.com/kaitranntt/ccs`);
+  console.log(`${colored('License:', 'cyan')} MIT`);
+  console.log('');
+
+  // Help hint
+  console.log(colored('Run \'ccs --help\' for usage information', 'yellow'));
 
-  console.log('https://github.com/kaitranntt/ccs');
   process.exit(0);
 }
 
-function handleHelpCommand(remainingArgs) {
-  const claudeCli = detectClaudeCli();
-  if (!claudeCli) {
-    showClaudeNotFoundError();
-    process.exit(1);
-  }
+function handleHelpCommand() {
+  // Title
+  console.log(colored('CCS (Claude Code Switch) - Instant profile switching for Claude CLI', 'bold'));
+  console.log('');
+
+  // Usage
+  console.log(colored('Usage:', 'cyan'));
+  console.log(`  ${colored('ccs', 'yellow')} [profile] [claude-args...]`);
+  console.log(`  ${colored('ccs', 'yellow')} [flags]`);
+  console.log('');
+
+  // Description
+  console.log(colored('Description:', 'cyan'));
+  console.log('  Switch between Claude models instantly. Stop hitting rate limits.');
+  console.log('  Maps profile names to Claude settings files via ~/.ccs/config.json');
+  console.log('');
+
+  // Profile Switching
+  console.log(colored('Profile Switching:', 'cyan'));
+  console.log(`  ${colored('ccs', 'yellow')}                         Use default profile`);
+  console.log(`  ${colored('ccs glm', 'yellow')}                     Switch to GLM profile`);
+  console.log(`  ${colored('ccs glm', 'yellow')} "debug this code"   Switch to GLM and run command`);
+  console.log(`  ${colored('ccs glm', 'yellow')} --verbose           Switch to GLM with Claude flags`);
+  console.log('');
+
+  // Flags
+  console.log(colored('Flags:', 'cyan'));
+  console.log(`  ${colored('-h, --help', 'yellow')}                  Show this help message`);
+  console.log(`  ${colored('-v, --version', 'yellow')}               Show version and installation info`);
+  console.log('');
+
+  // Configuration
+  console.log(colored('Configuration:', 'cyan'));
+  console.log('  Config File: ~/.ccs/config.json');
+  console.log('  Settings:    ~/.ccs/*.settings.json');
+  console.log('  Environment: CCS_CONFIG (override config path)');
+  console.log('');
+
+  // Examples
+  console.log(colored('Examples:', 'cyan'));
+  console.log('  # Try without installing');
+  console.log(`  ${colored('npx @kaitranntt/ccs glm', 'yellow')} "write tests"`);
+  console.log('');
+  console.log('  # Use default Claude subscription');
+  console.log(`  ${colored('ccs', 'yellow')} "Review this architecture"`);
+  console.log('');
+  console.log('  # Switch to GLM for cost-effective tasks');
+  console.log(`  ${colored('ccs glm', 'yellow')} "Write unit tests"`);
+  console.log('');
+  console.log('  # Use GLM with verbose output');
+  console.log(`  ${colored('ccs glm', 'yellow')} --verbose "Debug error"`);
+  console.log('');
+
+  // Uninstall
+  console.log(colored('Uninstall:', 'yellow'));
+  console.log('  npm:          npm uninstall -g @kaitranntt/ccs');
+  console.log('  macOS/Linux:  curl -fsSL ccs.kaitran.ca/uninstall | bash');
+  console.log('  Windows:      irm ccs.kaitran.ca/uninstall | iex');
+  console.log('');
+
+  // Documentation
+  console.log(colored('Documentation:', 'cyan'));
+  console.log(`  GitHub:  ${colored('https://github.com/kaitranntt/ccs', 'cyan')}`);
+  console.log('  Docs:    https://github.com/kaitranntt/ccs/blob/main/README.md');
+  console.log('  Issues:  https://github.com/kaitranntt/ccs/issues');
+  console.log('');
+
+  // License
+  console.log(`${colored('License:', 'cyan')} MIT`);
 
-  execClaude(claudeCli, ['--help', ...remainingArgs]);
+  process.exit(0);
 }
 
 function handleInstallCommand() {
-  // Implementation for --install (copy commands/skills to ~/.claude)
-  console.log('[Installing CCS Commands and Skills]');
-  console.log('Feature not yet implemented in Node.js standalone');
-  console.log('Use traditional installer for now:');
-  console.log('  curl -fsSL ccs.kaitran.ca/install | bash');
+  console.log('');
+  console.log('Feature not available');
+  console.log('');
+  console.log('The --install flag is currently under development.');
+  console.log('.claude/ integration testing is not complete.');
+  console.log('');
+  console.log('For updates: https://github.com/kaitranntt/ccs/issues');
+  console.log('');
   process.exit(0);
 }
 
 function handleUninstallCommand() {
-  // Implementation for --uninstall (remove commands/skills from ~/.claude)
-  console.log('[Uninstalling CCS Commands and Skills]');
-  console.log('Feature not yet implemented in Node.js standalone');
-  console.log('Use traditional uninstaller for now');
+  console.log('');
+  console.log('Feature not available');
+  console.log('');
+  console.log('The --uninstall flag is currently under development.');
+  console.log('.claude/ integration testing is not complete.');
+  console.log('');
+  console.log('For updates: https://github.com/kaitranntt/ccs/issues');
+  console.log('');
   process.exit(0);
 }
 
@@ -88,8 +173,7 @@ function main() {
 
   // Special case: help command
   if (firstArg === '--help' || firstArg === '-h' || firstArg === 'help') {
-    const remainingArgs = args.slice(1);
-    handleHelpCommand(remainingArgs);
+    handleHelpCommand();
     return;
   }
 

package/bin/helpers.js

@@ -4,16 +4,38 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-// Color formatting (TTY-aware)
-const useColors = process.stderr.isTTY && !process.env.NO_COLOR;
-const colors = useColors ? {
-  red: '\x1b[0;31m',
-  yellow: '\x1b[1;33m',
-  cyan: '\x1b[0;36m',
-  green: '\x1b[0;32m',
-  bold: '\x1b[1m',
-  reset: '\x1b[0m'
-} : { red: '', yellow: '', cyan: '', green: '', bold: '', reset: '' };
+// TTY-aware color detection (matches lib/ccs bash logic)
+function getColors() {
+  const forcedColors = process.env.FORCE_COLOR;
+  const noColor = process.env.NO_COLOR;
+  const isTTY = process.stdout.isTTY === true;  // Must be explicitly true
+
+  const useColors = forcedColors || (isTTY && !noColor);
+
+  if (useColors) {
+    return {
+      red: '\x1b[0;31m',
+      yellow: '\x1b[1;33m',
+      cyan: '\x1b[0;36m',
+      green: '\x1b[0;32m',
+      bold: '\x1b[1m',
+      reset: '\x1b[0m'
+    };
+  }
+
+  return { red: '', yellow: '', cyan: '', green: '', bold: '', reset: '' };
+}
+
+
+// Colors object (dynamic)
+const colors = getColors();
+
+// Helper: Apply color to text (returns plain text if colors disabled)
+function colored(text, colorName = 'reset') {
+  const currentColors = getColors();
+  const color = currentColors[colorName] || '';
+  return color ? `${color}${text}${currentColors.reset}` : text;
+}
 
 // Simple error formatting
 function error(message) {
@@ -44,6 +66,7 @@ function expandPath(pathStr) {
 
 module.exports = {
   colors,
+  colored,
   error,
   expandPath
 };

package/lib/ccs

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 # Version (updated by scripts/bump-version.sh)
-CCS_VERSION="2.4.5"
+CCS_VERSION="2.4.6"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 readonly CONFIG_FILE="${CCS_CONFIG:-$HOME/.ccs/config.json}"
 
@@ -52,9 +52,7 @@ show_help() {
   echo -e "${CYAN}Flags:${RESET}"
   echo -e "  ${YELLOW}-h, --help${RESET}                  Show this help message"
   echo -e "  ${YELLOW}-v, --version${RESET}               Show version and installation info"
-  echo -e "  ${YELLOW}--install${RESET}                   Install CCS commands to Claude CLI"
-  echo -e "  ${YELLOW}--uninstall${RESET}                 Remove CCS commands from Claude CLI"
-  echo ""
+    echo ""
   echo -e "${CYAN}Configuration:${RESET}"
   echo -e "  Config File: ~/.ccs/config.json"
   echo -e "  Settings:    ~/.ccs/*.settings.json"
@@ -70,10 +68,7 @@ show_help() {
   echo -e "  # Use GLM with verbose output"
   echo -e "  ${YELLOW}ccs glm${RESET} --verbose \"Debug error\""
   echo ""
-  echo -e "  # Install CCS task delegation"
-  echo -e "  ${YELLOW}ccs${RESET} --install"
-  echo ""
-  echo -e "${YELLOW}Uninstall:${RESET}"
+    echo -e "${YELLOW}Uninstall:${RESET}"
   echo -e "  macOS/Linux:  curl -fsSL ccs.kaitran.ca/uninstall | bash"
   echo -e "  Windows:      irm ccs.kaitran.ca/uninstall | iex"
   echo -e "  npm:          npm uninstall -g @kaitranntt/ccs"
@@ -122,8 +117,10 @@ Solutions:
 Restart your terminal after installation."
 }
 
-# Installation function for commands and skills
-install_commands_and_skills() {
+# WIP: .claude/ integration testing incomplete
+# Feature disabled until testing complete
+# install_commands_and_skills() {
+: <<'COMMENTED_OUT'
   # Try both possible locations for .claude directory
   local source_dir=""
   local possible_dirs=(
@@ -227,10 +224,13 @@ Solution:
   echo ""
   echo "You can now use the /ccs command in Claude CLI for task delegation."
   echo "Example: /ccs glm /plan 'add user authentication'"
-}
+COMMENTED_OUT
+# }
 
-# Uninstallation function for commands and skills
-uninstall_commands_and_skills() {
+# WIP: .claude/ integration testing incomplete
+# Feature disabled until testing complete
+# uninstall_commands_and_skills() {
+: <<'COMMENTED_OUT'
   local target_dir="$HOME/.claude"
   local removed_count=0
   local not_found_count=0
@@ -307,7 +307,8 @@ uninstall_commands_and_skills() {
   echo ""
   echo "The /ccs command is no longer available in Claude CLI."
   echo "To reinstall: ccs --install"
-}
+COMMENTED_OUT
+# }
 
 show_version() {
   echo -e "${BOLD}CCS (Claude Code Switch) v${CCS_VERSION}${RESET}"
@@ -344,14 +345,28 @@ fi
 
 # Special case: install command (check BEFORE profile detection)
 if [[ $# -gt 0 ]] && [[ "${1}" == "--install" ]]; then
-  install_commands_and_skills
-  exit $?
+  echo ""
+  echo "Feature not available"
+  echo ""
+  echo "The --install flag is currently under development."
+  echo ".claude/ integration testing is not complete."
+  echo ""
+  echo "For updates: https://github.com/kaitranntt/ccs/issues"
+  echo ""
+  exit 0
 fi
 
 # Special case: uninstall command (check BEFORE profile detection)
 if [[ $# -gt 0 ]] && [[ "${1}" == "--uninstall" ]]; then
-  uninstall_commands_and_skills
-  exit $?
+  echo ""
+  echo "Feature not available"
+  echo ""
+  echo "The --uninstall flag is currently under development."
+  echo ".claude/ integration testing is not complete."
+  echo ""
+  echo "For updates: https://github.com/kaitranntt/ccs/issues"
+  echo ""
+  exit 0
 fi
 
 # Smart profile detection: if first arg starts with '-', it's a flag not a profile

package/lib/ccs.ps1

@@ -104,9 +104,7 @@ function Show-Help {
     Write-ColorLine "Flags:" "Cyan"
     Write-ColorLine "  -h, --help                  Show this help message" "Yellow"
     Write-ColorLine "  -v, --version               Show version and installation info" "Yellow"
-    Write-ColorLine "  --install                   Install CCS commands to Claude CLI" "Yellow"
-    Write-ColorLine "  --uninstall                 Remove CCS commands from Claude CLI" "Yellow"
-    Write-Host ""
+        Write-Host ""
     Write-ColorLine "Configuration:" "Cyan"
     Write-Host "  Config File: ~/.ccs/config.json"
     Write-Host "  Settings:    ~/.ccs/*.settings.json"
@@ -122,10 +120,7 @@ function Show-Help {
     Write-Host "  # Use GLM with verbose output"
     Write-ColorLine "  ccs glm --verbose 'Debug error'" "Yellow"
     Write-Host ""
-    Write-Host "  # Install CCS task delegation"
-    Write-ColorLine "  ccs --install" "Yellow"
-    Write-Host ""
-    Write-ColorLine "Uninstall:" "Cyan"
+        Write-ColorLine "Uninstall:" "Cyan"
     Write-Host "  macOS/Linux:  curl -fsSL ccs.kaitran.ca/uninstall | bash"
     Write-Host "  Windows:      irm ccs.kaitran.ca/uninstall | iex"
     Write-Host "  npm:          npm uninstall -g @kaitranntt/ccs"
@@ -139,7 +134,7 @@ function Show-Help {
 }
 
 # Version (updated by scripts/bump-version.sh)
-$CcsVersion = "2.4.5"
+$CcsVersion = "2.4.6"
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 $ConfigFile = if ($env:CCS_CONFIG) { $env:CCS_CONFIG } else { "$env:USERPROFILE\.ccs\config.json" }
 
@@ -230,13 +225,27 @@ if ($Help) {
 
 # Special case: install command (check BEFORE profile detection)
 if ($FirstArg -eq "--install") {
-    Write-Host "Installation not implemented in this test version" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "Feature not available" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "The --install flag is currently under development."
+    Write-Host ".claude/ integration testing is not complete."
+    Write-Host ""
+    Write-Host "For updates: https://github.com/kaitranntt/ccs/issues"
+    Write-Host ""
     exit 0
 }
 
 # Special case: uninstall command (check BEFORE profile detection)
 if ($FirstArg -eq "--uninstall") {
-    Write-Host "Uninstallation not implemented in this test version" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "Feature not available" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "The --uninstall flag is currently under development."
+    Write-Host ".claude/ integration testing is not complete."
+    Write-Host ""
+    Write-Host "For updates: https://github.com/kaitranntt/ccs/issues"
+    Write-Host ""
     exit 0
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaitranntt/ccs",
-  "version": "2.4.5",
+  "version": "2.4.6",
   "description": "Claude Code Switch - Instant profile switching between Claude Sonnet 4.5 and GLM 4.6",
   "keywords": [
     "cli",