unified dual-tool configuration abstraction
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.
Unique: Implements a dual-tool adapter architecture where a unified configuration schema is translated into tool-specific formats via separate manager classes (Claude Code Configuration Manager and Codex Configuration Manager), rather than requiring users to maintain separate configs or learn each tool's native configuration system
vs alternatives: Eliminates configuration duplication and context-switching overhead that developers face when managing Claude Code and Codex independently, providing single-source-of-truth configuration management
multi-profile api provider switching with presets
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.
Unique: Implements a preset system with named profiles that persist across sessions, allowing instant provider switching via `config-switch` command without re-entering credentials, combined with provider-specific validation and model mapping for each tool adapter
vs alternatives: Faster than manually editing environment variables or configuration files for each provider switch, and more secure than hardcoding credentials in shell profiles
non-interactive configuration mode for ci/cd automation
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.
Unique: Implements environment variable-driven configuration with explicit `--non-interactive` flag that disables all prompts and validates all parameters before execution, enabling reliable CI/CD integration
vs alternatives: Provides explicit non-interactive mode with environment variable support, making ZCF suitable for CI/CD automation versus tools that default to interactive mode and require workarounds
uninstall and cleanup system
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.
Unique: Implements comprehensive uninstall with optional configuration preservation, removing not just npm package but also configuration directories, backups, and PATH modifications in single command
vs alternatives: Provides clean uninstall with optional data preservation, eliminating manual file cleanup that other tools require
toml-based configuration file management with schema validation
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.
Unique: Implements TOML-based configuration with schema validation on load, providing both human-readable format and programmatic validation, combined with hierarchical organization supporting tool-specific and workflow-specific overrides
vs alternatives: TOML format is more readable than JSON and supports comments, while schema validation catches configuration errors earlier than runtime discovery
language and model configuration per tool
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.
Unique: Implements per-tool language and model configuration with language-to-model mappings and language-specific prompt/output formatting, enabling specialized tool behavior per programming language
vs alternatives: Provides language-aware model selection and formatting, versus generic tools that apply same model and formatting to all languages
zero-configuration initialization with platform detection
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.
Unique: Combines OS-level platform detection (via Node.js `os` module) with environment variable inspection and file system probing to infer user context, then generates platform-specific configuration paths and defaults without requiring manual intervention
vs alternatives: Eliminates manual path configuration and OS-specific setup steps that plague multi-platform CLI tools, providing true zero-configuration experience on Windows, macOS, Linux, Termux, and WSL
workflow template system with customizable output styles
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.
Unique: Implements a template-based workflow system where each workflow is a TOML configuration defining step sequences, output styles, and AI personalities, combined with i18next-based internationalization allowing workflows to be localized across English, Chinese, and Japanese without code changes
vs alternatives: Provides pre-built enterprise workflows (BMad, SixStep, Git) that encode best practices, eliminating the need for users to manually orchestrate complex multi-step AI coding processes like other tools require
+6 more capabilities