zcf

Provides a single CLI interface that abstracts configuration complexity for two distinct AI coding tools (Claude Code VS Code extension and Codex terminal CLI) through tool-specific adapter pattern. Uses TOML-based configuration files with tool-specific managers that translate unified settings into tool-native formats, eliminating the need for users to manually configure each tool separately. Implements automatic platform detection and intelligent defaults to minimize required user input.

Manages multiple API provider configurations (OpenAI, Anthropic Claude, etc.) with instant switching capability through a preset system stored in TOML files. Users define named profiles containing API keys, model selections, and provider-specific settings, then switch between them via CLI commands without reconfiguring. The system validates API credentials and maintains provider-specific defaults for each tool adapter.

Supports fully automated configuration via environment variables and command-line flags without interactive prompts, enabling ZCF integration into CI/CD pipelines and automated deployment scripts. The system reads configuration from environment variables (e.g., `ZCF_API_KEY`, `ZCF_PROVIDER`, `ZCF_LANGUAGE`) and applies them without user interaction. Non-interactive mode validates all required parameters before proceeding and fails fast with clear error messages if configuration is incomplete.

Provides complete uninstallation capability that removes ZCF package, configuration files, and backup history with optional preservation of user data. The `uninstall` command removes npm package, deletes configuration directories, and cleans up any created symlinks or PATH modifications. Users can choose to preserve configurations for later restoration or completely remove all traces of ZCF from their system.

Uses TOML format for all configuration files with structured schema defining valid keys, types, and constraints. The system validates configuration files against schema on load, providing clear error messages for invalid configurations. Configuration is organized hierarchically (global ZCF config, tool-specific configs, workflow configs) with inheritance and override mechanisms. The system supports configuration comments and provides default values for optional keys.

Allows per-tool configuration of programming language support and AI model selection, with language-specific defaults and model-specific parameters. Users can specify which programming languages each tool should support, set default models for different task types, and configure language-specific prompts and output formatting. The system maintains language-to-model mappings and validates that selected models are available from configured API providers.

Automatically detects the user's operating system (Windows, macOS, Linux, Termux, WSL) and installs ZCF with platform-appropriate defaults and paths. The `init` command performs one-time setup including dependency validation, configuration directory creation, and interactive prompts for essential settings (API keys, preferred language, default models). Uses environment variable detection and file system checks to infer user preferences and minimize required input.

Provides pre-built workflow templates (SixStep Workflow, Git Workflow, BMad Enterprise Workflow) that define multi-step AI coding processes with customizable output styles and AI personalities. Templates are stored as configuration files that specify prompt sequences, tool invocations, and output formatting rules. Users can create custom workflows by extending template structure, and output styles control how AI responses are formatted (tone, detail level, structure). The system uses i18next for internationalization of workflow prompts and output styles.

Provides automated setup for Model Context Protocol (MCP) services through a configuration interface that handles service discovery, credential management, and tool-specific integration. Users select desired MCP services from a menu, and ZCF automatically configures them for both Claude Code and Codex with minimal manual intervention. The system manages MCP service credentials, validates service connectivity, and exposes MCP capabilities to the underlying AI tools through standardized integration points.

Monitors ZCF package version against npm registry and notifies users of available updates through the `check-updates` command. Implements semantic versioning validation and provides `update` command for in-place package upgrades with automatic configuration migration. The system maintains version compatibility checks for dependent tools (Claude Code, Codex) and validates configuration file compatibility across versions.

Provides full internationalization support for English, Chinese (Simplified), and Japanese through i18next framework integration. All CLI prompts, error messages, workflow templates, and output styles are translatable via JSON translation files organized by language code. The system auto-detects user locale from OS settings or allows explicit language selection via configuration, then loads appropriate translation files at runtime for all user-facing text.

Automatically creates timestamped backups of configuration files before modifications and provides recovery mechanism to restore previous configurations. The system maintains a backup history in a dedicated directory with metadata about each backup (timestamp, change description, version). Users can list available backups and restore to any previous state via CLI commands, with validation to ensure restored configurations are compatible with current ZCF version.

Implements a command-based CLI interface with both direct command invocation and interactive menu navigation. The router dispatches commands to appropriate handlers based on command name, with support for both interactive prompts and non-interactive flag-based invocation. The menu system provides hierarchical navigation through available commands with descriptions, enabling discoverability for users unfamiliar with CLI options. Commands include `init`, `update`, `menu`, `config-switch`, `check-updates`, `uninstall`, `ccr`, and `ccu`.

Provides integration points for external tools: CCR (Claude Code Router) for intelligent tool selection, Cometix for additional code analysis, and CCUsage for API usage tracking. The system detects installed external tools and exposes their functionality through ZCF commands (`ccr` and `ccu`), with automatic credential passing and output formatting. Integration is optional; ZCF functions without external tools but gains enhanced capabilities when they are installed.