ZCF

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![License][license-src]][license-href]
[![Claude Code][claude-code-src]][claude-code-href]
[![codecov][codecov-src]][codecov-href]
[![JSDocs][jsdocs-src]][jsdocs-href]
[![Ask DeepWiki][deepwiki-src]][deepwiki-href]

    ZCF - Zero-Config Code Flow

  English | 中文 | 日本語 | Changelog

✨ Full Documentation: ZCF Docs
One config for all your AI coding tools. ZCF installs the tools you pick and writes each one's own settings.

This is ZCF v5, a rewrite that is not published yet. Until it is, npx zcf still installs v3 (source at the zcf@3.7.3 tag), and zcf.ufomiao.com describes v3. To try v5 from source, see Contributing.

🚀 Quick Start

You keep one ZCF config: your provider, your MCP servers and your skills. ZCF installs the tools you pick and writes each tool's own settings with the tool's own commands, such as claude mcp add-json and npx skills add.

Supported tools: Claude Code, Codex, Gemini CLI, OpenCode, Cursor CLI, Pi and DeepSeek Harness.

Once v5 is published:

Nothing changes before you apply. ZCF edits only the keys it manages, keeps your comments and formatting, backs up each file before changing it, and never prints your keys. Coming from v3? See Coming from v3.

📖 Full Documentation

- Getting started, Config file, Commands and Agent tools
- Architecture: ADR 002

♥️ 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!…