# ufomiao/zcf

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/ufomiao-zcf).**

5,508 stars · 385 forks · TypeScript · mit

## Links

- GitHub: https://github.com/UfoMiao/zcf
- Homepage: http://zcf.ufomiao.com/
- awesome-repositories: https://awesome-repositories.com/repository/ufomiao-zcf.md

## Topics

`agent` `ai` `ai-agent` `bmad-method` `ccr` `claude` `claude-4` `claude-ai` `claude-code` `cli` `gpt` `gpt-5` `llm` `llm-code` `nodejs` `openai` `prompt` `typescript` `workflow` `zcf`

## Description

ZCF is a unified command-line environment manager that initializes, configures, and orchestrates multiple AI coding assistants within a single interface. It provides structured workflows for development, manages parallel Git worktrees, integrates Model Context Protocol (MCP) servers, and routes AI requests across multiple API providers to avoid vendor lock-in.

The tool distinguishes itself by enabling parallel development streams through Git worktrees, allowing simultaneous work on multiple branches with natural language control. It supports task-based model routing that selects the most appropriate AI provider per task, and offers a web-based dashboard for real-time monitoring and configuration of routing rules. Configuration management includes snapshot-based backups for safe rollback, and the interface supports bilingual display in both Chinese and English.

Additional capabilities include automated document generation from templates, semantic code search, multi-engine web search, and team template sharing. Environment setup is handled through a single command or interactive wizard, with extensive customization options for output style, status bar themes, and tool behavior.

## Tags

### Artificial Intelligence & ML

- [Coding Agent Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/coordination-and-routing/ai-agent-orchestrators/coding-agent-orchestrators.md) — Manages multiple AI coding agents from a single command-line interface, allowing seamless switching and shared configuration. ([source](https://zcf.ufomiao.com/ja-JP/))
- [Parallel Worktree Development Sessions](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agentic-workflows/worktree-isolation/parallel-worktree-development-sessions.md) — Executes independent development sessions simultaneously across multiple branches, compares results, and merges the best solution. ([source](https://zcf.ufomiao.com/en/cli/update))
- [MCP Server Management](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/model-context-protocol/mcp-server-management.md) — Integrates and configures MCP servers to extend AI capabilities with external tools and services.
- [AI Assistant Environment Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-assistant-environment-managers.md) — A unified manager that initializes, configures, and orchestrates multiple AI coding assistants inside a single CLI environment.
- [Model Request Routing](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-model-clients/model-request-routing.md) — Routes requests across multiple AI providers based on task type and complexity to optimize cost and availability. ([source](https://zcf.ufomiao.com/en/advanced/api-providers))
- [AI Request Routers](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-request-routers.md) — Routes AI requests across multiple API providers with flexible rules, proxy management, and usage monitoring.
- [AI Request Routing](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-request-routing.md) — Routes AI requests across multiple providers and proxy configurations to avoid lock-in and maintain availability.
- [MCP Protocol Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/external-tool-integrations/mcp-protocol-integrations.md) — Manages external tools and services as Model Context Protocol servers, enabling one-click activation and key injection.
- [Service Installers and Configurators](https://awesome-repositories.com/f/artificial-intelligence-ml/external-tool-integrations/mcp-protocol-integrations/service-installers-and-configurators.md) — Installs, configures, and removes Model Context Protocol services with one-click activation and dependency prompts.
- [External Service Activations](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-libraries/one-click-application/external-service-activations.md) — Enables external services like MCP servers, search, and browsing with a single click and environment variable prompts. ([source](https://zcf.ufomiao.com/en/getting-started/installation))
- [Localized](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-templates/localized.md) — Selects the language version for workflow templates, prompts, and system prompts used in automation. ([source](https://zcf.ufomiao.com/en/cli/menu))

### Part of an Awesome List

- [Environment Initializers](https://awesome-repositories.com/f/awesome-lists/ai/ai-coding-assistants/environment-initializers.md) — Sets up AI coding assistants like Claude Code and Codex with API keys, workflows, and MCP services in a single command.

### Development Tools & Productivity

- [Environment Setup](https://awesome-repositories.com/f/development-tools-productivity/ai-coding-assistants/environment-setup.md) — Runs a single command to detect OS, language, and current installations, then completes full environment setup including API, workflows, and MCP services. ([source](https://zcf.ufomiao.com/en/cli/ccr))
- [AI Provider Presets](https://awesome-repositories.com/f/development-tools-productivity/configuration-parsers/runtime-configuration-managers/ai-provider-presets.md) — Configures API access with login, API key, or proxy modes and applies predefined provider presets. ([source](https://zcf.ufomiao.com/en/features/claude-code))
- [Worktree Isolation Tools](https://awesome-repositories.com/f/development-tools-productivity/git-tooling/worktree-isolation-tools.md) — Creates isolated project versions using Git worktrees, allowing simultaneous work on multiple branches without interference.
- [Git Worktree Management](https://awesome-repositories.com/f/development-tools-productivity/version-control-repository-tools/version-control-managers/git-utilities/git-worktree-management.md) — Manages isolated Git worktrees for parallel development streams using plain English instructions.
- [Natural Language Worktree Controllers](https://awesome-repositories.com/f/development-tools-productivity/version-control-repository-tools/version-control-managers/git-utilities/submodule-and-worktree-management/worktree-reset/natural-language-worktree-controllers.md) — Creates, migrates, and deletes Git worktrees using plain English instructions, automatically configuring the IDE for the new worktree. ([source](https://zcf.ufomiao.com/))
- [Merged Branch Cleanup](https://awesome-repositories.com/f/development-tools-productivity/branch-management/merged-branch-cleanup.md) — Finds and safely deletes merged or expired Git branches with a dry-run preview mode and custom configuration. ([source](https://cdn.jsdelivr.net/gh/ufomiao/zcf@main/README.md))
- [Extensible Command and Preset Systems](https://awesome-repositories.com/f/development-tools-productivity/command-metadata-presets/extensible-command-and-preset-systems.md) — Defines presets, environment profiles, output styles, and service selections, and adds new commands, workflow templates, MCP services, and API provider presets. ([source](https://zcf.ufomiao.com/en/cli/ccr))
- [Safe Commit Reversals](https://awesome-repositories.com/f/development-tools-productivity/commit-history-analysis/commit-history-integration/safe-commit-reversals.md) — Safely rolls back to a prior commit by listing history, requiring confirmation, and supporting both reset and revert with backup. ([source](https://zcf.ufomiao.com/en/cli/init))
- [Workflow Chaining](https://awesome-repositories.com/f/development-tools-productivity/development-workflow-integration/workflow-chaining.md) — Chains multiple workflow types and integrates MCP services into comprehensive development pipelines. ([source](https://zcf.ufomiao.com/en/cli/check-updates))
- [Environment Configuration Management](https://awesome-repositories.com/f/development-tools-productivity/environment-configuration-management.md) — Manages output language, styles, memory instructions, permission templates, API modes, and proxy settings from a single CLI. ([source](https://zcf.ufomiao.com/en/features/ccr))
- [Shortcut-Driven Task Navigators](https://awesome-repositories.com/f/development-tools-productivity/navigation-shortcuts/shortcut-driven-task-navigators.md) — Displays dynamic, shortcut-driven menu items to execute common tasks without memorizing command syntax. ([source](https://zcf.ufomiao.com/en/features/))
- [Toolchain Versioning](https://awesome-repositories.com/f/development-tools-productivity/project-version-managers/toolchain-versioning.md) — Checks for newer versions of all managed tools and updates workflow templates, system prompts, and tool versions from a single command. ([source](https://zcf.ufomiao.com/zh-CN/))
- [Setup Wizards](https://awesome-repositories.com/f/development-tools-productivity/setup-wizards.md) — Guides through a wizard to select tools, configure API keys, install MCP services, and apply workflow templates. ([source](https://zcf.ufomiao.com/en/features/claude-code))
- [Third-Party Service Integrations](https://awesome-repositories.com/f/development-tools-productivity/third-party-service-integrations.md) — Installs and configures pre-built MCP services and additional tools like the CCR CLI and status bar through an interactive menu. ([source](https://zcf.ufomiao.com/en/advanced/templates))
- [Import and Customization](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-templates/import-and-customization.md) — Imports pre-built workflow scripts, installs them, resolves dependencies, and supports selective updates with merge strategies. ([source](https://zcf.ufomiao.com/en/features/claude-code))

### DevOps & Infrastructure

- [Git Command Execution](https://awesome-repositories.com/f/devops-infrastructure/git-command-execution.md) — Automates common Git operations including commits, rollbacks, branch cleaning, and worktree management via agent commands. ([source](https://zcf.ufomiao.com/en/cli/menu))
- [Multi-Stage Workflow Automations](https://awesome-repositories.com/f/devops-infrastructure/multi-stage-workflow-automations.md) — Guides projects through requirements analysis, design, task management, code generation, and stage approvals using pre-configured six-stage and feature workflows. ([source](https://zcf.ufomiao.com/ja-JP/))
- [Development Cycle Orchestration](https://awesome-repositories.com/f/devops-infrastructure/multi-stage-workflow-automations/development-cycle-orchestration.md) — Executes multi-stage development cycles with mandatory confirmation gates and automatic plan generation at each phase.
- [Conventional Commit Generators](https://awesome-repositories.com/f/devops-infrastructure/commit-message-generation/conventional-commit-generators.md) — Analyzes code changes to generate Conventional Commits messages with optional emoji and automatic splitting. ([source](https://zcf.ufomiao.com/en/features/))
- [Configuration Profile Switching](https://awesome-repositories.com/f/devops-infrastructure/configuration-profile-switching.md) — Creates, switches, versions, and rolls back configuration sets for different environments via CLI commands. ([source](https://zcf.ufomiao.com/en/features/ccr))
- [Personality Selections](https://awesome-repositories.com/f/devops-infrastructure/job-scheduling/job-behavior-configurations/agent-prompt-personalization/personality-selections.md) — Selects from pre-configured or custom output style templates to control the AI's communication tone and coding standards. ([source](https://zcf.ufomiao.com/en/advanced/api-providers))
- [Configuration File Organizers](https://awesome-repositories.com/f/devops-infrastructure/organization-configuration-management/configuration-file-organizers.md) — Manages, backs up, and organizes configuration files to support large-scale deployments and team collaboration. ([source](https://zcf.ufomiao.com/en/cli/ccr))
- [LLM Session Cost Dashboards](https://awesome-repositories.com/f/devops-infrastructure/resource-cost-management/cost-visualization-dashboards/llm-session-cost-dashboards.md) — Displays a live dashboard with active sessions, token burn rate, cost projections, and integration with a terminal status bar for quick reference. ([source](https://zcf.ufomiao.com/en/cli/menu))
- [Real-Time Status Displays](https://awesome-repositories.com/f/devops-infrastructure/version-control-management/version-control-integrations/git-status-indicators/real-time-status-displays.md) — Shows current Git branch, change counts, sync status, proxy routing state, and workflow stage progress in a real-time status display. ([source](https://zcf.ufomiao.com/en/features/workflows))

### Networking & Communication

- [AI Provider Proxies](https://awesome-repositories.com/f/networking-communication/api-proxies/ai-provider-proxies.md) — Routes AI requests across multiple providers through a configurable proxy, avoiding vendor lock-in and ensuring availability.

### Security & Cryptography

- [AI Provider Profiles](https://awesome-repositories.com/f/security-cryptography/account-management/ai-provider-profiles.md) — Selects primary, fast, balanced, or most-capable AI models per task and switches between stored API configuration profiles. ([source](https://zcf.ufomiao.com/en/features/codex))
- [AI Agent Role Assignments](https://awesome-repositories.com/f/security-cryptography/role-based-access-control/workspace-role-assignments/ai-agent-role-assignments.md) — Assigns functional development roles like product owner and architect to AI coding agents within a project. ([source](https://zcf.ufomiao.com/en/workflows/bmad))

### Software Engineering & Architecture

- [Incremental Implementation Workflows](https://awesome-repositories.com/f/software-engineering-architecture/incremental-implementation-workflows.md) — Provides a structured workflow from requirements analysis to implementation with task breakdown, approval steps, and automatic plan generation. ([source](https://zcf.ufomiao.com/en/features/ccusage))
- [Configuration Version Snapshots](https://awesome-repositories.com/f/software-engineering-architecture/configuration-state-snapshots/configuration-version-snapshots.md) — Maintains versioned configuration snapshots with automatic backups, enabling safe rollback and team sharing.

### User Interface & Experience

- [Bilingual Display Components](https://awesome-repositories.com/f/user-interface-experience/content-display-components/bilingual-display-components.md) — Displays all messages and documentation in both Chinese and English using a namespace-separated translation system. ([source](https://zcf.ufomiao.com/en/features/multi-config))
- [Language Configuration Settings](https://awesome-repositories.com/f/user-interface-experience/language-configuration-settings.md) — Configures the interface display language and the language used by AI assistants for replies and generated content. ([source](https://zcf.ufomiao.com/en/features/cometix))
- [Status Bar Customizers](https://awesome-repositories.com/f/user-interface-experience/status-bars/status-bar-customizers.md) — Customizes status bar segments and applies built-in themes to match personal preference. ([source](https://zcf.ufomiao.com/en/features/mcp))

### Data & Databases

- [Template-Based Reports](https://awesome-repositories.com/f/data-databases/custom-reporting-engines/template-based-reports.md) — Produces professional documents such as PRDs, architecture designs, and test plans from predefined templates. ([source](https://zcf.ufomiao.com/ja-JP/))

### System Administration & Monitoring

- [Proxy Lifecycle Management](https://awesome-repositories.com/f/system-administration-monitoring/proxy-lifecycle-management.md) — Starts, stops, restarts the proxy service, displays its status, and configures routing for AI network requests. ([source](https://zcf.ufomiao.com/))
- [Web Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring-dashboards/web-dashboards.md) — Provides a web interface with real-time monitoring, cost reports, and a graphical routing rule editor. ([source](https://zcf.ufomiao.com/en/cli/))
- [Cost and Token Trackers](https://awesome-repositories.com/f/system-administration-monitoring/usage-monitoring/token-usage-analytics/cost-and-token-trackers.md) — Collects, computes, and reports token consumption and cost metrics per session, model, and cache, with export to JSON or CSV. ([source](https://zcf.ufomiao.com/en/cli/))
- [AI Usage and Routing Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/usage-monitoring/usage-dashboard-builders/ai-usage-and-routing-dashboards.md) — Launches a browser interface with real-time usage statistics, route rule editing, and model management. ([source](https://zcf.ufomiao.com/en/cli/ccr))