How ufomiao/zcf works
ZCF is an interactive and scriptable CLI for initializing Claude Code and Codex environments. The main workflow selects a tool adapter, validates options, then configures the chosen environment; documented initialization can include workflows, API/CCR, and MCP setup. Separate commands handle menus, updates, switching, and uninstalling. The graph includes the shared configuration and installation layers. Some capability links rely on README statements or SOURCE INDEX references because their implementation excerpts were not provided.
Main entry points: legacy-init.ts Claude initialization · init.ts Init command · claude-code-config-manager.ts Claude config manager · cli-setup.ts Command registration
Components 29
CLI and commands
- CLI entry
src/cli.ts - Command registration
src/cli-setup.ts - Init command
src/commands/init.ts - Interactive menu
src/commands/menu.ts - Other commands
src/commands
Tool adapters
- Adapter registry
src/code-tools/registry.ts - Tool definitions
src/code-tools/definitions.ts - Claude adapter
src/code-tools/claude-code/adapter.ts - Claude initialization
src/code-tools/claude-code/legacy-init.ts - Codex adapter
src/code-tools/codex/adapter.ts - Codex configuration
src/utils/code-tools/codex.ts
Setup capabilities
- Workflow setup
src/config/workflows.ts - API providers
src/config/api-providers.ts - MCP services
src/config/mcp-services.ts - Setup installer
src/utils/installer.ts
Configuration and state
- Claude config manager
src/utils/claude-code-config-manager.ts - Claude config helpers
src/utils/claude-config.ts - CCR configuration
src/utils/ccr/config.ts - ZCF configuration
src/utils/zcf-config.ts - General configuration
src/utils/config.ts - JSON configuration I/O
src/utils/json-config.ts - Claude config model
src/types/claude-code-config.ts
Shared utilities
- Filesystem and platform
src/utils/fs-operations.ts - Platform support
src/utils/platform.ts - Feature operations
src/utils/features.ts - CLI presentation
src/utils/banner.ts - Prompt controls
src/utils/toggle-prompt.ts - Error handling
src/utils/error-handler.ts
Other components
- CLI user
Connections 29
- CLI user → CLI entry: runs
README.md - CLI entry → Command registration: starts
src/cli.ts - Command registration → Init command: registers
src/cli-setup.ts - Command registration → Interactive menu: registers
src/cli-setup.ts - Command registration → Other commands: registers
src/cli-setup.ts - Interactive menu → Init command: dispatches
src/commands/menu.ts - Init command → Adapter registry: selects adapter
src/commands/init.ts - Init command → Claude initialization: validates options
src/commands/init.ts - Init command → CLI presentation: displays
src/commands/init.ts - Adapter registry → Tool definitions: uses definitions
src/code-tools/index.ts - Claude adapter → Claude initialization: delegates initialization
- Codex adapter → Codex configuration: uses
src/code-tools/codex/adapter.ts - Claude initialization → Workflow setup: configures workflows
src/code-tools/claude-code/legacy-init.ts - Claude initialization → API providers: configures providers
src/code-tools/claude-code/legacy-init.ts - Claude initialization → MCP services: configures MCP
src/code-tools/claude-code/legacy-init.ts - Claude initialization → Setup installer: uses
src/code-tools/claude-code/legacy-init.ts - Claude config manager → ZCF configuration: reads and writes
src/utils/claude-code-config-manager.ts - Claude config manager → Claude config helpers: updates settings
src/utils/claude-code-config-manager.ts - Claude config manager → CCR configuration: reads CCR
src/utils/claude-code-config-manager.ts - Claude config helpers → JSON configuration I/O: writes JSON
src/utils/claude-config.ts - General configuration → Filesystem and platform: uses filesystem
src/utils/config.ts - General configuration → JSON configuration I/O: uses JSON I/O
src/utils/config.ts - ZCF configuration → Filesystem and platform: uses filesystem
src/utils/zcf-config.ts - Setup installer → Platform support: checks platform
src/utils/installer.ts - Setup installer → Filesystem and platform: uses filesystem
src/utils/installer.ts - Claude config manager → Claude config model: uses model
src/utils/claude-code-config-manager.ts - Interactive menu → Feature operations: offers features
src/commands/menu.ts - Init command → Error handling: handles errors
src/commands/init.ts - Claude initialization → Prompt controls: prompts user
src/code-tools/claude-code/legacy-init.ts