6BNBN/FlowPilot：FlowPilot 是一个单文件 CLI 工具，通过集成 Claude Code、Codex、Cursor 等 AI 客户端，将自然语言需求自动本页整理它解决什么问题、适用场景、安装方式和使用方法。
FlowPilot 是一个单文件 CLI 工具，通过集成 Claude Code、Codex、Cursor 等 AI 客户端，将自然语言需求自动拆解为并行任务，实现从编码、测试到提交的全流程自动化开发。
FlowPilot 是一个面向 AI 客户端的全自动开发流程工具，定位为“端到端自动化开发引擎”。其核心用途是让用户通过一句自然语言需求，触发从任务拆解、并行编码、测试验证到 Git 提交的完整闭环，将开发者从重复性操作中解放，专注于需求定义与验收。项目以单文件 CLI 形式交付，通过生成客户端专属 instruction file（如 CLAUDE.md、AGENTS.md）深度集成 Claude Code、Codex、Cursor、snow-cli 等，实现“一句话需求，喝杯咖啡回来代码已就绪”的体验。
FlowPilot 针对传统 AI 辅助开发的四大痛点提供解决方案：1）状态持久化与断点恢复——所有进度写入磁盘文件，支持中断后一键继续，避免对话历史丢失；2）上下文膨胀控制——主 Agent 仅读取进度文件（<100 行），结合四层记忆系统管理长期知识；3）并行调度与效率——自动分析任务依赖，批量并发无冲突子任务（Codex 最多 50 个），最大化开发速度；4）质量与可维护性——每个任务自动提交 Git，收尾阶段自动运行 build/test/lint，并通过自我进化引擎持续优化流程。相比原生 Task 工具，FlowPilot 提供了状态持久化、自动并行、跨会话记忆和自动化验证等关键增强。
FlowPilot 适用于以下场景：1）使用 Claude Code、Codex、Cursor 或 snow-cli 等 AI 客户端的项目开发，尤其适合 Node.js、Python、Go、Rust、Java、C++、Makefile 等多语言环境；2）需求明确但实现繁琐的功能开发，如脚手架搭建、模块迁移、重复模式编码；3）需要高可靠性的长期或复杂任务，依赖其断点恢复与三层边界控制（dirty baseline、ownership、cleanup）避免操作污染；4）与 OpenSpec 规格文档配合的自动化实现流程，FlowPilot 可自动解析 checkbox 格式任务并执行；5）团队希望减少人工协调、提升编码效率，通过并行调度与自动提交加速交付。
FlowPilot 的安装分为构建与部署两步：1）在 FlowPilot 仓库目录执行 `npm install && npm run build`，使用 tsup 编译生成单文件 `dist/flow.js`；2）将 `dist/flow.js` 复制到目标项目根目录即可使用，或通过 `npm run setup && npm link` 全局安装 `flow` 命令。项目依赖 Node.js 20+ 和 TypeScript 工具链（tsup、vitest 等），所有依赖均列于 package.json，无额外系统要求。对于 Codex 用户，还需在 `~/.codex/config.toml` 中配置 `max_threads = 50` 以启用最大并行度。
使用 FlowPilot 的核心流程为：1）在目标项目目录执行 `node flow.js init`，选择目标 AI 客户端（Claude Code/Codex/Cursor/snow-cli），系统生成对应 instruction file 与配置（如 CLAUDE.md、AGENTS.md）；2）启动所选客户端（如 `claude --dangerously-skip-permissions` 或 `codex --yolo`），在对话中描述开发需求；3）FlowPilot 自动拆解任务、并行调度子 Agent、实时上报进度，并在每个任务完成后自动提交 Git；4）中断后通过 `--continue` 参数（Claude Code）或说“继续任务”（其他客户端）恢复流程，状态从磁盘加载。收尾阶段自动执行 build/test/lint 验证，并通过自我进化引擎记录经验。
FlowPilot 的关键实现特点包括：1）多客户端适配层——根据初始化选择生成差异化 instruction file，并为 Codex 注入子任务契约与并行调度规则；2）三层边界控制——通过 dirty baseline 记录启动前脏文件、checkpoint ownership 声明任务归属文件、setup-owned cleanup 自动清理注入物，严格隔离用户操作与自动化变更；3）四层记忆系统——结合 LLM 与规则引擎提取知识，使用 BM25 与 Dense 向量双路检索、MMR 重排序与时间衰减，在 `next` 时自动注入相关记忆；4）自我进化引擎——Reflect→Experiment→Review 三阶段循环，成功/失败均触发参数优化，退化时自动回滚；5）OpenSpec 集成——任务解析器兼容 checkbox 格式，支持
FlowPilot 是一个单文件 CLI 工具，通过集成 Claude Code、Codex、Cursor 等 AI 客户端，将自然语言需求自动拆解为并行任务，实现从编码、测试到提交的全流程自动化开发。
FlowPilot 是一个面向 AI 客户端的全自动开发流程工具，定位为“端到端自动化开发引擎”。其核心用途是让用户通过一句自然语言需求，触发从任务拆解、并行编码、测试验证到 Git 提交的完整闭环，将开发者从重复性操作中解放，专注于需求定义与验收。项目以单文件 CLI 形式交付，通过生成客户端专属 instruction file（如 CLAUDE.md、AGENTS.md）深度集成 Claude Code、Codex、Cursor、snow-cli 等，实现“一句话需求，喝杯咖啡回来代码已就绪”的体验。
FlowPilot 的安装分为构建与部署两步：1）在 FlowPilot 仓库目录执行 `npm install && npm run build`，使用 tsup 编译生成单文件 `dist/flow.js`；2）将 `dist/flow.js` 复制到目标项目根目录即可使用，或通过 `npm run setup && npm link` 全局安装 `flow` 命令。项目依赖 Node.js 20+ 和 TypeScript 工具链（tsup、vitest 等），所有依赖均列于 package.json，无额外系统要求。对于 Codex 用户，还需在 `~/.codex/config.toml` 中配置 `max_threads = 50` 以启用最大并行度。
使用 FlowPilot 的核心流程为：1）在目标项目目录执行 `node flow.js init`，选择目标 AI 客户端（Claude Code/Codex/Cursor/snow-cli），系统生成对应 instruction file 与配置（如 CLAUDE.md、AGENTS.md）；2）启动所选客户端（如 `claude --dangerously-skip-permissions` 或 `codex --yolo`），在对话中描述开发需求；3）FlowPilot 自动拆解任务、并行调度子 Agent、实时上报进度，并在每个任务完成后自动提交 Git；4）中断后通过 `--continue` 参数（Claude Code）或说“继续任务”（其他客户端）恢复流程，状态从磁盘加载。收尾阶段自动执行 build/test/lint 验证，并通过自我进化引擎记录经验。