zcf  by UfoMiao

Zero-config Claude-Code Flow setup and management

Created 1 month ago
1,535 stars

Top 27.1% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a zero-configuration, one-click setup for Claude Code, an AI-powered coding assistant, with bilingual support and an intelligent agent system. It aims to streamline the setup and management of Claude Code, offering enhanced features like a Claude Code Router (CCR) for model access and cost optimization, and the BMad workflow for enterprise-grade AI agent development.

How It Works

ZCF utilizes Node.js and npm to manage the installation and configuration of Claude Code and its associated tools. It offers an interactive menu-driven interface for guided setup, allowing users to select languages, AI personalities, API authentication methods, and install various AI agent workflows and MCP (Model Configuration Provider) services. The Claude Code Router (CCR) acts as a proxy, enabling the use of free AI models and custom routing rules for cost savings.

Quick Start & Requirements

  • Install/Run: npx zcf (opens interactive menu) or npx zcf i (full initialization).
  • Prerequisites: Node.js and npm.
  • Optional: Exa AI API key for Exa AI Search MCP service.
  • Docs: https://github.com/UfoMiao/zcf

Highlighted Details

  • Supports bilingual interaction (Chinese/English) for prompts and AI output.
  • Introduces the BMad workflow for structured, team-based AI agent development.
  • Claude Code Router (CCR) enables free model access and custom routing for cost optimization.
  • Offers multiple AI personalities and a six-phase development workflow.

Maintenance & Community

The project is actively maintained, with recent enhancements to CCR and the introduction of the BMad workflow. Community contributions are acknowledged, and sponsorship is encouraged.

Licensing & Compatibility

The project is released under the MIT License, permitting commercial use and integration with closed-source projects.

Limitations & Caveats

Users who previously used ZCF v2.9.1 to initialize CCR need to re-run the CCR initialization due to an incorrect package name in that version. The README mentions using pnpm for development builds, but npm is used for user installation via npx.

Health Check
Last Commit

21 hours ago

Responsiveness

Inactive

Pull Requests (30d)
28
Issues (30d)
25
Star History
855 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.