CLAUDE

Commands Module

Last Updated: Mon Oct 27 19:39:26 CST 2025

Root > src > commands

Module Responsibilities

CLI command implementation module containing all major command functions for ZCF, providing both interactive and non-interactive operation interfaces for Claude Code environment setup and management.

Entry Points and Startup

• Main Entry Points:
  • init.ts - Complete initialization flow with full setup options (45KB, 1,200+ lines)
  • menu.ts - Interactive menu system with feature selection (13KB, 350+ lines)
  • update.ts - Workflow template updates without full reinstall (4KB, 100+ lines)
  • ccr.ts - Claude Code Router proxy configuration (1KB, 30+ lines)
  • ccu.ts - CCusage tool integration and execution (1KB, 40+ lines)
  • check-updates.ts - Tool version checking and update management (1.3KB, 50+ lines)
  • config-switch.ts - Configuration switching for multi-provider support (14KB, 400+ lines)
  • uninstall.ts - ZCF uninstallation with selective removal (10KB, 300+ lines)

External Interfaces

Command Interfaces

// Initialize command options (v3.3.0+)
export interface InitOptions {
  configLang?: SupportedLang
  aiOutputLang?: AiOutputLanguage | string
  force?: boolean
  skipBanner?: boolean
  skipPrompt?: boolean
  codeType?: CodeToolType | string // Support 'cc', 'cx' abbreviations
  // Non-interactive mode parameters
  configAction?: 'new' | 'backup' | 'merge' | 'docs-only' | 'skip'
  apiType?: 'auth_token' | 'api_key' | 'ccr_proxy' | 'skip'
  apiKey?: string // Used for both API key and auth token
  apiUrl?: string
  apiModel?: string // Primary API model
  apiFastModel?: string // Fast API model
  provider?: string // API provider preset (302ai, glm, minimax, kimi, custom)
  mcpServices?: string[] | string | boolean
  workflows?: string[] | string | boolean
  outputStyles?: string[] | string | boolean
  defaultOutputStyle?: string
  allLang?: string // Unified language parameter
  installCometixLine?: string | boolean // CCometixLine installation control
  // Multi-configuration parameters
  apiConfigs?: string // JSON string for multiple API configurations
  apiConfigsFile?: string // Path to JSON file with API configurations
}

// Update command options
export interface UpdateOptions {
  lang?: SupportedLang
  force?: boolean
  selectedWorkflows?: string[]
}

// CCR command options
export interface CcrOptions {
  lang?: SupportedLang
}

// Check updates options
export interface CheckUpdatesOptions {
  lang?: SupportedLang
  codeType?: CodeToolType | string
}

// Config switch options
export interface ConfigSwitchOptions {
  codeType?: CodeToolType | string
  list?: boolean
}

// Uninstall options
export interface UninstallOptions {
  mode?: 'complete' | 'custom' | 'interactive'
  items?: string
  lang?: SupportedLang
}