How do I install zcf?

Run these in Claude Code: npx -y skills add UfoMiao/zcf --agent claude-code. Then prompt normally.

Does zcf auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Development

Plugin

zcf

Zero-Config Code Flow for Claude code & Codex

FLOW.md

ufomiao@ufomiao

GitHub

Plugin Signal82/100Strong

maintained98

capable67

documented75

adopted81

Install

$ npx -y skills add UfoMiao/zcf --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

TypeScript Bash AWS Linux Git

+5 tags

GitHub Anthropic OpenAI Gemini MCP

6,077

Stars

425

Forks

Active

Maintenance

TypeScript

Language

MIT

License

1h ago

Last commit

1y ago

Created

Repo: UfoMiao/zcf

In this plugin

12 skills 4 agents

See everything inside

What's inside

Skills

/zcf-add-sponsorQuickly add a new corporate sponsor to ZCF — sponsor list by default, with optional API preset and documentation ad placements /zcf-prCreate pull request based on current branch changes /zcf-releaseAutomate version release and code commit using changeset /zcf-update-docsAutomatically check code changes since last tag and update documentation in docs/ directory (en, zh-CN, ja-JP) and CLAUDE.md to ensure consistency with actual code implementation /bmad-initInitialize or update BMad-Method (V6) in your project /featAdd New Feature

Show all 20 skills

/git-clean-branchesSafely find and clean up merged or stale Git branches with dry-run mode and custom base/protected branches support /git-commitAnalyze changes with Git only and auto-generate conventional commit messages with optional emoji; suggests splitting commits when needed, runs local Git hooks by default (use --no-verify to skip)/git-rollbackInteractively rollback Git branch to historical version; lists branches, versions, then executes reset/revert after confirmation /git-worktreeManage Git worktrees in project-level ../.zcf/project-name/ directory with smart defaults, IDE integration and content migration /init-projectInitialize project AI context, generate/update root-level and module-level CLAUDE.md indexes /workflowProfessional AI programming assistant with structured workflow (Research -> Ideate -> Plan -> Execute -> Optimize -> Review) for developers /bmad-init在项目中初始化或更新 BMad-Method (V6)/feat用于新增功能开发的命令，支持完整的开发流程和工具集成 /git-clean-branches安全查找并清理已合并或过期的 Git 分支，支持 dry-run 模式与自定义基准/保护分支 /git-commit仅用 Git 分析改动并自动生成 conventional commit 信息（可选 emoji）；必要时建议拆分提交，默认运行本地 Git 钩子（可 --no-verify 跳过）/git-rollback交互式回滚 Git 分支到历史版本；列分支、列版本、二次确认后执行 reset / revert /git-worktree管理 Git worktree，在项目平级的 ../.zcf/项目名/ 目录下创建，支持智能默认、IDE 集成和内容迁移 /init-project初始化项目 AI 上下文，生成/更新根级与模块级 CLAUDE.md 索引 /workflow专业AI编程助手，提供结构化六阶段开发工作流（研究→构思→计划→执行→优化→评审），适用于专业开发者

Agents

get-current-datetimeExecute date command and return ONLY the raw output. No formatting, headers, explanations, or parallel agents.init-architectAdaptive initialization: concise at root + detailed at module level; staged traversal with coverage reporting plannerUse this agent when the user presents a complex task or project that needs to be broken down into manageable steps and documented for review. Examples: <example>Context: User wants to implement a new feature for their Tauri application. user: 'I need to add a group chat ui-ux-designerUse this agent when you need UI/UX design guidance, Current Project UI Framework implementation advice, or visual design improvements for the desktop application interface. Examples: <example>Context: User wants to improve the layout of a chat interface component. user: "I want

README

Read on GitHub

✨ Full Documentation: ZCF Docs

Zero-config, one-click setup for Claude Code & Codex with bilingual support, intelligent agent system and personalized AI assistant

🚀 Quick Start

Recommended: npx zcf opens the interactive menu — pick what you need.
Common commands:

npx zcf i        # Full initialization: install + workflows + API/CCR + MCP
npx zcf u        # Update workflows only
npx zcf --lang zh-CN  # Switch interface language (example)

Non-interactive example (provider preset):

npx zcf i -s -p 302ai -k "sk-xxx"

More usage, options, and workflows: see documentation.

📖 Full Documentation

https://zcf.ufomiao.com/

♥️ Sponsors

Thanks to AICodeMirror for sponsoring this project! AICodeMirror provides highly reliable official relay services for Claude, Codex, and Gemini, supporting enterprise-grade concurrency, fast invoice issuance, and dedicated 24/7 technical support. Official Codex access is available for as little as 7% of the standard price, with additional discounts on account top-ups! AICodeMirror also offers an exclusive benefit to users of the ZCF project: register through this link to receive 20% off your first top-up.

This project is sponsored by Z.ai, supporting us with their GLM CODING PLAN. GLM CODING PLAN is a subscription service designed for AI coding, starting at just $10/month. It provides access to their flagship GLM-5.2 model across 10+ popular AI coding tools (Claude Code, Cline, Roo Code, etc.), offering developers top-tier, fast, and stable coding experiences. Get 10% OFF GLM CODING PLAN：https://z.ai/subscribe?ic=8JVLJQFSKB

Thanks to code0.ai for sponsoring this project! code0.ai is an AI coding workspace for developers and technical teams, bringing together mainstream Agent coding capabilities such as Claude Code and Codex. It supports common development scenarios including code generation, project understanding, debugging, code review, and documentation. It is suitable for independent developers, Agent engineers, open-source maintainers, and enterprise R&D teams, with invoicing and team onboarding supported. Register through the exclusive link and contact customer support to claim free test credits and experience a more efficient AI coding workflow.

Thanks to Claude API for sponsoring this project! Claude API is an official-channel API provider focused on Claude models. Built on Anthropic official keys and AWS Bedrock official channels, it provides a stable integration experience for Claude Code and Agent applications, supports the full Claude model family, and preserves official capabilities such as Tool Use and long context. The service is not reverse-engineered and does not downgrade model capabilities, making it suitable for heavy Claude Code users, Agent engineers, and enterprise technical teams. Register through the exclusive link and contact customer support to claim free test credits. Invoicing and team onboarding are also supported.

PatewayAI is a high-quality model API relay service provider focused on official direct connections for serious AI developers, offering the full range of Claude and Codex series models. 100% official source supply with no adulteration — open to inspection. Transparent billing with token-level invoices auditable line by line. Enterprise-grade concurrency support with a dedicated management platform for enterprise customers, including formal contracts and invoicing. PatewayAI offers an exclusive benefit for ZCF users: register via this link to get $3 free trial credit, recharges as low as 60% off, with bilateral invite rewards up to $150!

302.AI is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.

💬 Community

Join our Telegram group for support, discussions, and updates:

🙏 Acknowledgments

This project is inspired by and incorporates work from:

Thanks to these community contributors for sharing!

❤️ Support & Sponsors

If you find this project helpful, please consider sponsoring its development. Your support is greatly appreciated!

Our Sponsors

A huge thank you to all our sponsors for their generous support!

【Corporate Sponsors】

302.AI (first corporate sponsorship 🤠)
GLM (first AI model sponsorship 🤖)
PackyCode (first API proxy service sponsor 🧝🏻‍♀️)
APIKEY.FUN (enterprise AI relay sponsor 🎁)
AICodeMirror (official high-stability relay service sponsor 🪞)
UUCode (sponsored $100 proxy credits 💰)
Crazyrouter (AI API aggregation gateway sponsor 🚀)
PatewayAI (official direct-connect relay service sponsor 🛡️)
code0 (AI coding workspace sponsor 🎁)
Claude API (Claude official API provider sponsor 🎁)
AIHub (high-availability AI API relay platform sponsor 🎁)

【Individual Sponsors】

Tc (first sponsor)
Argolinhas (first ko-fi sponsor ٩(•̤̀ᵕ•̤́๑))
r*r (first anonymous sponsor 🤣)
**康 (first KFC sponsor 🍗)
*东 (first coffee sponsor ☕️)
炼*3 (first Termux user sponsor 📱)
chamo101 (first GitHub issue sponsor 🎉)
初屿贤 (first Codex user sponsor 🙅🏻‍♂️)
Protein (first 1688 sponsor 😏)
musistudio (first open source project author sponsor, the author of CCR 🤩)
*年 (first 100 CNY sponsor 💴)
BeatSeat (community expert 😎, provided $1000 Claude credits)
wenwen (community expert 🤓, provided daily $100 Claude&GPT credits)
16°C coffee (My best friend 🤪, offered ChatGPT Pro $200 package)

Promotion Thanks

Thanks to the following authors for promoting this project:

逛逛 GitHub, article: https://mp.weixin.qq.com/s/phqwSRb16MKCHHVozTFeiQ
Geek, tweet: https://x.com/geekbb/status/1955174718618866076

📄 License

MIT License

🚀 Contributors

⭐️ Star History

If this project helps you, please give me a ⭐️ Star!

File tree

614

UfoMiao/zcfView on GitHub

.changeset/
  config.json
  README.md
.claude/
  hooks/
    eslint-hook.ts
  index.json
  settings.json
  skills/
    zcf-add-sponsor/
      SKILL.md
    zcf-pr/
      SKILL.md
    zcf-release/
      SKILL.md
    zcf-update-docs/
      SKILL.md
.github/
  PUBLISHING.md
  PULL_REQUEST_TEMPLATE
  workflows/
    ci.yml
    docs-deploy.yml
    release.yml
.gitignore
.husky/
  commit-msg
  prepare-commit-msg
.vscode/
  settings.json
.zcf/
  plan/
    history/
      2026-01-09_001414_fix-toml-top-level-fields.md
      2026-01-12_085710_fix-issue-259-mcp-config-corruption.md
      2026-01-12_091556_更新codex模型配置选项.md
      2026-01-28_004229_remove-codex-chat-format.md
      2026-01-30_191017_add-aicodemirror-preset.md
      add-ccu-command.md
      add-completed-onboarding-fix.md
      add-dangerous-operations-confirmation.md
      add-doc-update-check.md
      add-numbers-to-prompts.md
      add-unit-tests.md
      ai-language-selection.md
      ai-personality-config.md
      api-config-enhancement.md
      api-key-selection.md
      api-modification-flow-enhancement.md
      api-provider-selection.md
      api-refactor-summary.md
      bmad-migration.md
      ccc-init.md
      ccometixline-statusline-config.md
      ccr-integration.md
      ccr-menu-feature.md
      ccr-skip-option.md
      ccr-test-enhancement.md
      ccr-test-fix-summary.md
      ccr-unit-tests.md
      Claude-Code-Multi-Config-TDD-Plan.md
      claude-code-multi-config.md
      codex-constants-refactor.md
      codex-fixes-final-report.md
      codex-fixes-summary.md
      codex-mcp-extra-fields-preservation.md
      codex-windows-mcp-fix.md
      codex增量配置管理.md
      codex完整备份机制TDD开发.md
      cometix-integration.md
      command-optimization.md
      complete-ccu-tests-and-docs.md
      complete-tests-and-docs.md
      default-model-and-language-config.md
      docs-vitepress-migration.md
      env-permission-config.md
      eslint-fix.md
      exa-mcp-config-update.md
      extract-multiselect-hint.md
      fix-ai-personality-display-issue.md
      fix-api-partial-modify-menu-return.md
      fix-ccr-tests.md
      fix-claude-md-config.md
      fix-commandExists-bug.md
      fix-test-errors.md
      fix-tests-and-add-coverage.md
      fix-tests-and-update-docs.md
      fix-undefined-output.md
      fix-windows-hook.md
      fix-windows-path-encoding.md
      git-workflow-testing.md
      gitbook-documentation-migration.md
      gitbook-zh-doc-update.md
      graceful-exit-handling.md
      husky-配置任务.md
      i18n-cleanup.md
      i18n-namespace-refactor.md
      i18n-refactor.md
      i18next-重构计划.md
      i18n静态键值对重构.md
      ide-detection-smart.md
      init-test-coverage-enhancement.md
      mcp-auto-config.md
      mcp-configuration-optimization.md
      mcp-services-refactor.md
      menu-feature.md
      optimize-settings-config.md
      optimize-workflow-requirement-scoring.md
      permission-cleanup-task.md
      pnpm-10-升级修复.md
      readme-update.md
      refactor-git-workflow-templates.md
      refactor-module-independence.md
      refactor-output-styles-to-common.md
      refactor-sixStep-config-dir-to-zcf.md
      refactor-sixStep-to-common.md
      remove-flaky-time-tests.md
      remove-noExistingConfig-check.md
      settings-merge-enhancement.md
      shortcut-mapping.md
      simplified-skip-prompt-params.md
      skip-prompt-feature.md
      technical-guides-implementation.md
      template-restructure.md
      termux-support.md
      test-coverage-100.md
      test-coverage-improvement-summary.md
      test-file-merge.md
      update-docs-for-v2.3.0.md
      update-help-command.md
      update-readme-for-ccr.md
      version-check-update.md
      windows-mcp-support.md
      workflow-refactor.md
      wsl-support.md
      zcf-update-docs-codex-support.md
      优化bmad-init模板.md
      修复所有ts-eslint-测试报错.md
      修改sixStep工作流路径结构-2025-12-16.md
      修正硬编码i18n.md
      增加commitlint.md
      新增serena-mcp服务.md
      查看暂存区的更改,codex的工作流安装增加了git工作流指令,需要在相关的流程增加选项,和claude code选项描述一样就行.md
      测试优化-版本检查冗余清理.md
      测试修复和语言参数清理.md
      测试架构重构方案.md
      测试覆盖率提升.md
      渐进式测试覆盖率提升计划.md
      精简README并更新文档链接.md
      自定义模型选择功能.md
      补全文档翻译.md
AGENTS.md
bin/
  zcf.mjs
build.config.ts
CHANGELOG.md
CLAUDE.md
CODE_OF_CONDUCT.md
commitlint.config.ts
CONTRIBUTING.md
cspell.json
docs/
  .vitepress/
    config.ts
    theme/
      components/
        TopBanner.vue
      custom.css
      index.ts
  CNAME
  en/
    .gitbook.yaml
    advanced/
      api-providers.md
      configuration.md
      i18n.md
      index.md
      templates.md
      troubleshooting.md
    best-practices/
      index.md
      output-styles.md
      tips.md
      worktree.md
    cli/
      ccr.md
      ccu.md
      check-updates.md
      config-switch.md
      index.md
      init.md
      menu.md
      uninstall.md
      update.md
    development/
      architecture.md
      contributing.md
      index.md
      testing.md
    features/
      ccr.md
      ccusage.md
      claude-code.md
      codex.md
      cometix.md
      index.md
      mcp.md
      multi-config.md
      workflows.md
    getting-started/
      index.md
      installation.md
    index.md
    SUMMARY.md
    workflows/
      bmad.md
      feat.md
      git-commands.md
      index.md
      spec.md
      zcf-workflow.md
  index.md
  ja-JP/
    advanced/
      api-providers.md
      configuration.md
      i18n.md
      index.md
      templates.md
      troubleshooting.md
    best-practices/
      index.md
      output-styles.md
      tips.md
      worktree.md
    cli/
      ccr.md
      ccu.md
      check-updates.md
      config-switch.md
      index.md
      init.md
      menu.md
      uninstall.md
      update.md
    development/
      architecture.md
      contributing.md
      index.md
      testing.md
    features/
      ccr.md
      ccusage.md
      claude-code.md
      codex.md
      cometix.md
      index.md
      mcp.md
      multi-config.md
      workflows.md
    getting-started/
      index.md
      installation.md
    index.md
    SUMMARY.md
    workflows/
      bmad.md
      feat.md
      git-commands.md
      index.md
      spec.md
      zcf-workflow.md
  package.json
  public/
    assets/
      favicon.ico
      Haleclipse.webp
  tsconfig.json
  uno.config.ts
  zh-CN/
    .gitbook.yaml
    advanced/
      api-providers.md
      configuration.md
      i18n.md
      index.md
      templates.md
      troubleshooting.md
    best-practices/
      index.md
      output-styles.md
      tips.md
      worktree.md
    cli/
      ccr.md
      ccu.md
      check-updates.md
      config-switch.md
      index.md
      init.md
      menu.md
      uninstall.md
      update.md
    development/
      architecture.md
      contributing.md
      index.md
      testing.md
    features/
      ccr.md
      ccusage.md
      claude-code.md
      codex.md
      cometix.md
      index.md
      mcp.md
      multi-config.md
      workflows.md
    getting-started/
      index.md
      installation.md
    index.md
    SUMMARY.md
    workflows/
      bmad.md
      feat.md
      git-commands.md
      index.md
      spec.md
      zcf-workflow.md
eslint.config.ts
LICENSE
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
README_ja-JP.md
README_zh-CN.md
README.md
src/
  assets/
    302.ai-en.jpg
    302.ai-jp.jpg
    302.ai.jpg
    AICodeMirror.jpg
    AICodeMirror.png
    aihub.jpg
    alipay.webp
    apikey-fun.png
    banner.webp
    claude-api-en.jpg
    claude-api.jpg
    code0-en.jpg
    code0.jpg
    crazyrouter.svg
    GLM-en.png
    GLM.png
    logo.png
    packycode.png
    pateway.ai-en.png
    pateway.ai.png
    wechat.webp
  cli-setup.ts
  cli.ts
  commands/
    ccr.ts
    ccu.ts
    check-updates.ts
    CLAUDE.md
    config-switch.ts
    init.ts
    menu.ts
    uninstall.ts
    update.ts
  config/
    api-providers.ts
    CLAUDE.md
    mcp-services.ts
    workflows.ts
  constants.ts
  i18n/
    CLAUDE.md
    index.ts
    locales/
      en/
        api.json
        ccr.json
        cli.json
        codex.json
        cometix.json
        common.json
        configuration.json
        errors.json
        installation.json
        language.json
        mcp.json
        menu.json
        multi-config.json
        tools.json
        uninstall.json
        updater.json
... 335 more

FAQ

zcf is a Claude Code plugin with 20 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes zcf-add-sponsor, zcf-pr, zcf-release. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is zcf?: Zero-Config Code Flow for Claude code & Codex
How do I install zcf?: Run these in Claude Code: npx -y skills add UfoMiao/zcf --agent claude-code. Then prompt normally.
Does zcf auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is zcf free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.