@jonnyhoo/ccs 1.0.0

package/scripts/completion/ccs.zsh

@@ -0,0 +1,308 @@
+#compdef ccs
+
+# Zsh completion for CCS (Claude Code Switch)
+# Compatible with zsh 5.0+
+#
+# Installation:
+#   Add to ~/.zshrc:
+#     fpath=(~/.zsh/completion $fpath)
+#     autoload -Uz compinit && compinit
+#     source /path/to/ccs/scripts/completion/ccs.zsh
+#
+#   Or install system-wide:
+#     sudo cp scripts/completion/ccs.zsh /usr/local/share/zsh/site-functions/_ccs
+
+# Set up completion styles for better formatting and colors
+zstyle ':completion:*:*:ccs:*:commands' list-colors '=(#b)(auth|api|cliproxy|doctor|sync|update)([[:space:]]#--[[:space:]]#*)==0\;34=2\;37'
+zstyle ':completion:*:*:ccs:*:proxy-profiles' list-colors '=(#b)(gemini|codex|agy|qwen)([[:space:]]#--[[:space:]]#*)==0\;35=2\;37'
+zstyle ':completion:*:*:ccs:*:model-profiles' list-colors '=(#b)(default|glm|glmt|kimi|[^[:space:]]##)([[:space:]]#--[[:space:]]#*)==0\;32=2\;37'
+zstyle ':completion:*:*:ccs:*:account-profiles' list-colors '=(#b)([^[:space:]]##)([[:space:]]#--[[:space:]]#*)==0\;33=2\;37'
+zstyle ':completion:*:*:ccs:*' group-name ''
+zstyle ':completion:*:*:ccs:*:descriptions' format $'\n%B%F{yellow}── %d ──%f%b'
+zstyle ':completion:*:*:ccs:*' list-separator '  --  '
+zstyle ':completion:*:*:ccs:*' list-rows-first true
+zstyle ':completion:*:*:ccs:*' menu select
+
+_ccs() {
+  local -a commands proxy_profiles settings_profiles_described account_profiles_described cliproxy_variants_described
+  local curcontext="$curcontext" state line
+  typeset -A opt_args
+
+  # Define top-level commands
+  commands=(
+    'auth:Manage multiple Claude accounts'
+    'api:Manage API profiles (create/remove)'
+    'cliproxy:Manage CLIProxy variants and binary'
+    'doctor:Run health check and diagnostics'
+    'sync:Sync delegation commands and skills'
+    'update:Update CCS to latest version'
+  )
+
+  # Define CLIProxy hardcoded profiles (OAuth providers)
+  proxy_profiles=(
+    'gemini:Google Gemini (OAuth)'
+    'codex:OpenAI Codex (OAuth)'
+    'agy:Antigravity (OAuth)'
+    'qwen:Qwen Code (OAuth)'
+  )
+
+  # Define known settings profiles with descriptions
+  local -A profile_descriptions
+  profile_descriptions=(
+    'default' 'Default Claude Sonnet 4.5'
+    'glm'     'GLM-4.6 (cost-optimized)'
+    'glmt'    'GLM-4.6 with thinking mode'
+    'kimi'    'Kimi for Coding (long-context)'
+  )
+
+  # Load settings-based profiles from config.json
+  if [[ -f ~/.ccs/config.json ]]; then
+    local -a raw_settings_profiles
+    raw_settings_profiles=(${(f)"$(jq -r '.profiles | keys[]' ~/.ccs/config.json 2>/dev/null)"})
+
+    for profile in $raw_settings_profiles; do
+      local desc="${profile_descriptions[$profile]:-Settings-based profile}"
+      settings_profiles_described+=("${profile}:${desc}")
+    done
+  fi
+
+  # Load account-based profiles from profiles.json
+  if [[ -f ~/.ccs/profiles.json ]]; then
+    local -a raw_account_profiles
+    raw_account_profiles=(${(f)"$(jq -r '.profiles | keys[]' ~/.ccs/profiles.json 2>/dev/null)"})
+
+    for profile in $raw_account_profiles; do
+      account_profiles_described+=("${profile}:Account-based profile")
+    done
+  fi
+
+  # Load cliproxy variants from config.json
+  if [[ -f ~/.ccs/config.json ]]; then
+    local -a raw_cliproxy_variants
+    raw_cliproxy_variants=(${(f)"$(jq -r '.cliproxy | keys[]' ~/.ccs/config.json 2>/dev/null)"})
+
+    for variant in $raw_cliproxy_variants; do
+      cliproxy_variants_described+=("${variant}:CLIProxy variant")
+    done
+  fi
+
+  _arguments -C \
+    '(- *)'{-h,--help}'[Show help message]' \
+    '(- *)'{-v,--version}'[Show version information]' \
+    '(- *)'{-sc,--shell-completion}'[Install shell completion]' \
+    '1: :->command' \
+    '*:: :->args'
+
+  case $state in
+    command)
+      _describe -t commands 'commands' commands
+      _describe -t proxy-profiles 'CLIProxy profiles' proxy_profiles
+      _describe -t model-profiles 'model profiles' settings_profiles_described
+      _describe -t account-profiles 'account profiles' account_profiles_described
+      _describe -t cliproxy-variants 'CLIProxy variants' cliproxy_variants_described
+      ;;
+
+    args)
+      case $words[1] in
+        auth)
+          _ccs_auth
+          ;;
+        api)
+          _ccs_api
+          ;;
+        cliproxy)
+          _ccs_cliproxy
+          ;;
+        update)
+          _arguments \
+            '--force[Force reinstall current version]' \
+            '--beta[Install from dev channel]' \
+            '--dev[Install from dev channel]' \
+            '(- *)'{-h,--help}'[Show help]'
+          ;;
+        doctor)
+          _arguments \
+            '(- *)'{-h,--help}'[Show help for doctor command]'
+          ;;
+        gemini|codex|agy|qwen)
+          _arguments \
+            '--auth[Authenticate only]' \
+            '--config[Change model configuration]' \
+            '--logout[Clear authentication]' \
+            '--headless[Headless auth (for SSH)]' \
+            '(- *)'{-h,--help}'[Show help]'
+          ;;
+        --shell-completion|-sc)
+          _arguments \
+            '--bash[Install for bash]' \
+            '--zsh[Install for zsh]' \
+            '--fish[Install for fish]' \
+            '--powershell[Install for PowerShell]'
+          ;;
+        *)
+          _message 'Claude CLI arguments'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_ccs_api() {
+  local curcontext="$curcontext" state line
+  typeset -A opt_args
+
+  local -a api_commands settings_profiles
+
+  api_commands=(
+    'create:Create new API profile (interactive)'
+    'list:List all API profiles'
+    'remove:Remove an API profile'
+  )
+
+  if [[ -f ~/.ccs/config.json ]]; then
+    settings_profiles=(${(f)"$(jq -r '.profiles | keys[]' ~/.ccs/config.json 2>/dev/null)"})
+  fi
+
+  _arguments -C \
+    '(- *)'{-h,--help}'[Show help for api commands]' \
+    '1: :->subcommand' \
+    '*:: :->subargs'
+
+  case $state in
+    subcommand)
+      _describe -t api-commands 'api commands' api_commands
+      ;;
+
+    subargs)
+      case $words[1] in
+        create)
+          _arguments \
+            '1:profile name:' \
+            '--base-url[API base URL]:url:' \
+            '--api-key[API key]:key:' \
+            '--model[Default model]:model:' \
+            '--force[Overwrite existing profile]' \
+            {--yes,-y}'[Skip prompts]'
+          ;;
+        list)
+          ;;
+        remove|delete|rm)
+          _arguments \
+            '1:profile:($settings_profiles)' \
+            {--yes,-y}'[Skip confirmation]'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_ccs_cliproxy() {
+  local curcontext="$curcontext" state line
+  typeset -A opt_args
+
+  local -a cliproxy_commands cliproxy_variants providers
+
+  cliproxy_commands=(
+    'create:Create new CLIProxy variant profile'
+    'list:List all CLIProxy variant profiles'
+    'remove:Remove a CLIProxy variant profile'
+  )
+
+  providers=(gemini codex agy qwen)
+
+  if [[ -f ~/.ccs/config.json ]]; then
+    cliproxy_variants=(${(f)"$(jq -r '.cliproxy | keys[]' ~/.ccs/config.json 2>/dev/null)"})
+  fi
+
+  _arguments -C \
+    '(- *)'{-h,--help}'[Show help for cliproxy commands]' \
+    '--install[Install specific version]:version:' \
+    '--latest[Install latest version]' \
+    '1: :->subcommand' \
+    '*:: :->subargs'
+
+  case $state in
+    subcommand)
+      _describe -t cliproxy-commands 'cliproxy commands' cliproxy_commands
+      ;;
+
+    subargs)
+      case $words[1] in
+        create)
+          _arguments \
+            '1:variant name:' \
+            '--provider[Provider name]:provider:($providers)' \
+            '--model[Model name]:model:' \
+            '--force[Overwrite existing variant]' \
+            {--yes,-y}'[Skip prompts]'
+          ;;
+        list|ls)
+          ;;
+        remove|delete|rm)
+          _arguments \
+            '1:variant:($cliproxy_variants)' \
+            {--yes,-y}'[Skip confirmation]'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_ccs_auth() {
+  local curcontext="$curcontext" state line
+  typeset -A opt_args
+
+  local -a auth_commands account_profiles
+
+  auth_commands=(
+    'create:Create new profile and login'
+    'list:List all saved profiles'
+    'show:Show profile details'
+    'remove:Remove saved profile'
+    'default:Set default profile'
+  )
+
+  if [[ -f ~/.ccs/profiles.json ]]; then
+    account_profiles=(${(f)"$(jq -r '.profiles | keys[]' ~/.ccs/profiles.json 2>/dev/null)"})
+  fi
+
+  _arguments -C \
+    '(- *)'{-h,--help}'[Show help for auth commands]' \
+    '1: :->subcommand' \
+    '*:: :->subargs'
+
+  case $state in
+    subcommand)
+      _describe -t auth-commands 'auth commands' auth_commands
+      ;;
+
+    subargs)
+      case $words[1] in
+        create)
+          _message 'new profile name'
+          _arguments '--force[Allow overwriting existing profile]'
+          ;;
+        list)
+          _arguments \
+            '--verbose[Show additional details]' \
+            '--json[Output in JSON format]'
+          ;;
+        show)
+          _arguments \
+            '1:profile:($account_profiles)' \
+            '--json[Output in JSON format]'
+          ;;
+        remove)
+          _arguments \
+            '1:profile:($account_profiles)' \
+            {--yes,-y}'[Skip confirmation prompts]'
+          ;;
+        default)
+          _arguments '1:profile:($account_profiles)'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_ccs "$@"

package/scripts/dev-install.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# Auto-install CCS locally for testing changes
+# Usage: ./scripts/dev-install.sh
+#
+# Options:
+#   --skip-validate  Skip validation (faster, use when you're sure code is good)
+#   --npm            Force npm install (default: auto-detect, fallback to bun)
+#   --bun            Force bun install
+
+set -e
+
+SKIP_VALIDATE=false
+FORCE_NPM=false
+FORCE_BUN=false
+
+for arg in "$@"; do
+    case $arg in
+        --skip-validate) SKIP_VALIDATE=true ;;
+        --npm) FORCE_NPM=true ;;
+        --bun) FORCE_BUN=true ;;
+    esac
+done
+
+echo "[i] CCS Dev Install - Starting..."
+
+# Get to the right directory
+cd "$(dirname "$0")/.."
+
+# Detect installation method
+# Priority: CLI flags > existing global install location > bun (default)
+detect_pkg_manager() {
+    if [ "$FORCE_NPM" = true ]; then
+        echo "npm"
+        return
+    fi
+
+    if [ "$FORCE_BUN" = true ]; then
+        echo "bun"
+        return
+    fi
+
+    # Check existing ccs installation location
+    CCS_PATH=$(which ccs 2>/dev/null || true)
+
+    if [ -n "$CCS_PATH" ]; then
+        # Check if installed via bun
+        if [[ "$CCS_PATH" == *".bun"* ]]; then
+            echo "bun"
+            return
+        fi
+        # Check if installed via npm
+        if [[ "$CCS_PATH" == *"npm"* ]] || [[ "$CCS_PATH" == *"node_modules"* ]]; then
+            echo "npm"
+            return
+        fi
+    fi
+
+    # Default fallback: bun (preferred)
+    echo "bun"
+}
+
+PKG_MANAGER=$(detect_pkg_manager)
+echo "[i] Detected package manager: $PKG_MANAGER"
+
+# Build TypeScript first
+echo "[i] Building TypeScript..."
+bun run build
+
+# Pack the npm package
+echo "[i] Creating package..."
+if [ "$SKIP_VALIDATE" = true ]; then
+    # Skip validation, just pack
+    npm pack --ignore-scripts 2>/dev/null || bun pm pack --ignore-scripts
+else
+    # Full pack with validation (runs prepublishOnly)
+    npm pack 2>/dev/null || bun pm pack
+fi
+
+# Find the tarball
+TARBALL=$(ls -t kaitranntt-ccs-*.tgz 2>/dev/null | head -1)
+
+if [ -z "$TARBALL" ]; then
+    echo "[X] ERROR: No tarball found"
+    exit 1
+fi
+
+echo "[i] Found tarball: $TARBALL"
+
+# Install globally using detected package manager
+echo "[i] Installing globally with $PKG_MANAGER..."
+
+if [ "$PKG_MANAGER" = "bun" ]; then
+    # Remove existing to avoid duplicate key warnings in bun's global package.json
+    # (bun add -g appends instead of replacing file: protocol entries)
+    bun remove -g @kaitranntt/ccs 2>/dev/null || true
+    # Bun requires file: protocol for local tarballs
+    bun add -g "file:$(pwd)/$TARBALL"
+else
+    npm install -g "$TARBALL"
+fi
+
+# Clean up
+echo "[i] Cleaning up..."
+rm "$TARBALL"
+
+echo "[OK] Complete! CCS is now updated."
+echo ""
+echo "Test with: ccs --version"

package/scripts/dev-release.sh

@@ -0,0 +1,123 @@
+#!/bin/bash
+# Dev Release Script
+# Calculates version based on current stable, not semantic-release's predicted next version.
+# Pattern: {stable}-dev.{N} where N increments for each dev release.
+#
+# Example:
+#   main at v6.7.1 → dev releases: 6.7.1-dev.1, 6.7.1-dev.2, ...
+#   main releases v6.7.2 → dev releases: 6.7.2-dev.1, 6.7.2-dev.2, ...
+
+set -euo pipefail
+
+# Colors for output (respects NO_COLOR)
+if [[ -z "${NO_COLOR:-}" ]] && [[ -t 1 ]]; then
+  RED='\033[0;31m'
+  GREEN='\033[0;32m'
+  YELLOW='\033[1;33m'
+  NC='\033[0m'
+else
+  RED=''
+  GREEN=''
+  YELLOW=''
+  NC=''
+fi
+
+log_info() { echo -e "${GREEN}[i]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[!]${NC} $1"; }
+log_error() { echo -e "${RED}[X]${NC} $1"; }
+
+# Ensure we have the latest tags
+git fetch --tags origin main
+
+# Get latest stable tag from main (exclude prereleases like -dev, -beta, -rc)
+# Match only clean semver tags: vX.Y.Z
+STABLE_TAG=$(git tag -l "v[0-9]*.[0-9]*.[0-9]" --merged origin/main --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -1 || echo "")
+
+if [ -z "$STABLE_TAG" ]; then
+  log_warn "No stable tags found on main, defaulting to v0.0.0"
+  STABLE_TAG="v0.0.0"
+fi
+
+STABLE=${STABLE_TAG#v}
+log_info "Current stable version: ${STABLE}"
+
+# Find latest dev tag for this stable version
+LATEST_DEV=$(git tag -l "v${STABLE}-dev.*" --sort=-v:refname | head -1 || echo "")
+
+# Calculate next dev number
+if [ -z "$LATEST_DEV" ]; then
+  DEV_NUM=1
+  log_info "No existing dev tags for ${STABLE}, starting at dev.1"
+else
+  DEV_NUM=$(echo "$LATEST_DEV" | sed 's/.*dev\.\([0-9]*\)/\1/')
+  DEV_NUM=$((DEV_NUM + 1))
+  log_info "Latest dev tag: ${LATEST_DEV}, incrementing to dev.${DEV_NUM}"
+fi
+
+VERSION="${STABLE}-dev.${DEV_NUM}"
+log_info "New version: ${VERSION}"
+
+# Check if tag already exists (safety check)
+if git rev-parse "v${VERSION}" >/dev/null 2>&1; then
+  log_error "Tag v${VERSION} already exists!"
+  exit 1
+fi
+
+# Update package.json
+npm version "$VERSION" --no-git-tag-version
+log_info "Updated package.json to ${VERSION}"
+
+# Configure git for GitHub Actions
+git config user.name "github-actions[bot]"
+git config user.email "github-actions[bot]@users.noreply.github.com"
+
+# Commit version change
+git add package.json
+git commit -m "chore(release): ${VERSION} [skip ci]"
+log_info "Created release commit"
+
+# Create tag
+git tag "v${VERSION}"
+log_info "Created tag v${VERSION}"
+
+# Push commit and tag
+git push origin dev
+git push origin "v${VERSION}"
+log_info "Pushed to origin"
+
+# Publish to npm with dev tag
+npm publish --tag dev
+log_info "Published to npm with @dev tag"
+
+# Generate release notes from commits since last tag
+PREV_TAG=$(git tag -l "v*" --sort=-v:refname | sed -n '2p' || echo "")
+if [ -n "$PREV_TAG" ]; then
+  # Get commits between previous tag and the one before our release commit
+  NOTES=$(git log --pretty=format:"- %s" "${PREV_TAG}..HEAD~1" 2>/dev/null | grep -v "chore(release):" | head -15 || echo "- Dev release")
+else
+  NOTES="- Dev release based on ${STABLE}"
+fi
+
+# Create GitHub prerelease
+gh release create "v${VERSION}" \
+  --title "v${VERSION}" \
+  --notes "${NOTES}" \
+  --prerelease
+
+log_info "Created GitHub prerelease"
+
+# Save release info for Discord notification
+# This file is read by send-discord-release.cjs for dev releases
+cat > .dev-release-info.json << EOF
+{
+  "version": "${VERSION}",
+  "notes": $(echo "$NOTES" | jq -Rs .)
+}
+EOF
+log_info "Saved release info for Discord notification"
+
+# Output for GitHub Actions
+echo "version=${VERSION}" >> "${GITHUB_OUTPUT:-/dev/null}"
+echo "released=true" >> "${GITHUB_OUTPUT:-/dev/null}"
+
+log_info "Dev release ${VERSION} complete!"

package/scripts/dev-symlink.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+# CCS Dev Symlink Setup
+# Creates symlinks for testing dev version with 'ccs' command
+#
+# Usage: ./scripts/dev-symlink.sh [--restore]
+#
+# Without --restore: Creates symlink from global 'ccs' to dist/ccs.js
+# With --restore: Restores original global 'ccs' from backup
+
+set -euo pipefail
+
+RESTORE=false
+
+# Parse arguments
+for arg in "$@"; do
+    case $arg in
+        --restore) RESTORE=true ;;
+        -h|--help)
+            echo "Usage: $0 [--restore]"
+            echo ""
+            echo "Create symlink for dev testing:"
+            echo "  $0"
+            echo ""
+            echo "Restore original global ccs:"
+            echo "  $0 --restore"
+            exit 0
+            ;;
+        *)
+            echo "[X] Unknown option: $arg"
+            echo "Use --help for usage"
+            exit 1
+            ;;
+    esac
+done
+
+# Get to the right directory
+cd "$(dirname "$0")/.."
+
+# Check if dist/ccs.js exists
+if [ ! -f "dist/ccs.js" ]; then
+    echo "[X] ERROR: dist/ccs.js not found. Run 'bun run build' first."
+    exit 1
+fi
+
+# Get absolute path to dev ccs.js
+DEV_CCS_PATH="$(pwd)/dist/ccs.js"
+
+# Find global ccs installation
+GLOBAL_CCS_PATH=$(which ccs 2>/dev/null || true)
+
+if [ -z "$GLOBAL_CCS_PATH" ]; then
+    echo "[X] ERROR: No global 'ccs' installation found."
+    echo "Install CCS globally first: npm install -g @kaitranntt/ccs"
+    exit 1
+fi
+
+echo "[i] Found global ccs at: $GLOBAL_CCS_PATH"
+
+if [ "$RESTORE" = true ]; then
+    # Restore original ccs from backup
+    BACKUP_PATH="${GLOBAL_CCS_PATH}.backup-dev"
+
+    if [ ! -f "$BACKUP_PATH" ] && [ ! -L "$BACKUP_PATH" ]; then
+        echo "[X] ERROR: No backup found at $BACKUP_PATH"
+        echo "Cannot restore - backup may have been deleted"
+        exit 1
+    fi
+
+    echo "[i] Restoring original ccs from backup..."
+    rm -f "$GLOBAL_CCS_PATH"
+    if [ -L "$BACKUP_PATH" ]; then
+        # Restore symlink
+        cp -P "$BACKUP_PATH" "$GLOBAL_CCS_PATH"
+    else
+        # Restore regular file
+        cp "$BACKUP_PATH" "$GLOBAL_CCS_PATH"
+    fi
+    chmod +x "$GLOBAL_CCS_PATH"
+    rm -f "$BACKUP_PATH"
+
+    echo "[OK] Restored original global ccs"
+    echo "Run 'ccs --version' to verify"
+    exit 0
+fi
+
+# Check if already symlinked to our dev version
+if [ -L "$GLOBAL_CCS_PATH" ]; then
+    CURRENT_TARGET=$(readlink "$GLOBAL_CCS_PATH" 2>/dev/null || true)
+    if [ "$CURRENT_TARGET" = "$DEV_CCS_PATH" ]; then
+        echo "[OK] Already symlinked to dev version"
+        exit 0
+    fi
+fi
+
+# Create backup of current global ccs
+BACKUP_PATH="${GLOBAL_CCS_PATH}.backup-dev"
+if [ -f "$BACKUP_PATH" ] || [ -L "$BACKUP_PATH" ]; then
+    echo "[i] Backup already exists, skipping backup creation"
+else
+    echo "[i] Creating backup of current global ccs..."
+    cp -P "$GLOBAL_CCS_PATH" "$BACKUP_PATH"
+    echo "[OK] Backup created at: $BACKUP_PATH"
+fi
+
+# Create symlink
+echo "[i] Creating symlink to dev version..."
+rm -f "$GLOBAL_CCS_PATH"
+ln -s "$DEV_CCS_PATH" "$GLOBAL_CCS_PATH"
+
+echo "[OK] Symlinked global 'ccs' to dev version"
+echo ""
+echo "Now you can test dev changes with: ccs <command>"
+echo "To restore original: $0 --restore"
+echo ""
+echo "Test with: ccs --version"

package/scripts/get-version.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Get current CCS version
+# Usage: ./scripts/get-version.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CCS_DIR="$(dirname "$SCRIPT_DIR")"
+VERSION_FILE="$CCS_DIR/VERSION"
+
+if [[ -f "$VERSION_FILE" ]]; then
+    cat "$VERSION_FILE"
+else
+    echo "unknown"
+    exit 1
+fi