{"_id":"loopforge-cli","_rev":"5-23cce3f4388878e233cd93616021256b","name":"loopforge-cli","dist-tags":{"alpha":"0.1.0-alpha.1","latest":"0.2.2"},"versions":{"0.1.0-alpha.1":{"name":"loopforge-cli","version":"0.1.0-alpha.1","license":"MIT","_id":"loopforge-cli@0.1.0-alpha.1","maintainers":[{"name":"roberttwang","email":"1183605593@qq.com"}],"bin":{"loopforge":"bin/loopforge.mjs"},"dist":{"shasum":"62143976dac07872c3908611917f00932fd4dac2","tarball":"https://registry.npmjs.org/loopforge-cli/-/loopforge-cli-0.1.0-alpha.1.tgz","fileCount":299,"integrity":"sha512-iDvG+eWTa6Lfyl+9Colrc7ltCYFFbPFtXsGqNvrG9FMjymAM7gxxzLyWoOhIeaMEhZtQCwWbwQv1fpR0+p4izg==","signatures":[{"sig":"MEUCIQCm9BH5DYbn7YEy1g/MnjhWfm2Fu2GuV08g4MYnrriTyAIgGHCrM5/EPyej8yvaZ4WQM2dNI5hXhwkI9KpwPbrFqhA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":988066},"type":"module","engines":{"node":">=20"},"gitHead":"5e8d322f0189a1ff92582f6657237a5418219215","scripts":{"test":"bash scripts/smoke-npm.sh","pack:check":"npm pack --dry-run"},"_npmUser":{"name":"roberttwang","email":"1183605593@qq.com"},"_npmVersion":"11.7.0","description":"Installer for DevFlow Classic and Portable agent workflows","directories":{},"_nodeVersion":"20.19.6","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/loopforge-cli_0.1.0-alpha.1_1784549115007_0.4658461434754606","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"loopforge-cli","version":"0.1.0","keywords":["ai-agents","multi-agent","coding-agent","codex","claude-code","cursor","codebuddy"],"license":"MIT","_id":"loopforge-cli@0.1.0","maintainers":[{"name":"roberttwang","email":"1183605593@qq.com"}],"homepage":"https://github.com/Tencent/LoopForge#readme","bugs":{"url":"https://github.com/Tencent/LoopForge/issues"},"bin":{"loopforge":"bin/loopforge.mjs"},"dist":{"shasum":"5050dfa7d664de22dc9166ee8390fe9011717b85","tarball":"https://registry.npmjs.org/loopforge-cli/-/loopforge-cli-0.1.0.tgz","fileCount":298,"integrity":"sha512-adbWkaw7hPcr9G/W+mQgpNgCoHywJrwgiAdXxNkiRwWmCfoyh/T7eIWGnSGPrTivuxM5v87mHd+pBuvzgay7yQ==","signatures":[{"sig":"MEUCIHgL5zWIQhARv+WO8g6/rKwIQ6DSBU38RuNTsBItoimdAiEAyTVhhupkxJw84UREqmcMPbpdSeKZmbYYZBSiCK/WDiE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIGP5hgE+j3Q4fyVbjx5fyMzD6U/G4WHcj24J6hB4ycQzAiEAnSrGhia16mqoEv3Ac6rnSsTXdkNQZdgZL3qjwR0K9dc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/loopforge-cli@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":998026},"type":"module","engines":{"node":">=20"},"gitHead":"09c765286f549624dd95434e1e6ef2249657cbeb","scripts":{"test":"bash scripts/smoke-npm.sh","pack:check":"npm pack --dry-run"},"_npmUser":{"name":"roberttwang","email":"1183605593@qq.com"},"repository":{"url":"git+https://github.com/Tencent/LoopForge.git","type":"git"},"_npmVersion":"10.9.8","description":"Multi-agent development workflows for CodeBuddy, Codex, Cursor, and Claude Code","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/loopforge-cli_0.1.0_1789026849707_0.17622208402890593","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"loopforge-cli","version":"0.2.0","keywords":["ai-agents","multi-agent","coding-agent","codex","claude-code","cursor","codebuddy"],"license":"MIT","_id":"loopforge-cli@0.2.0","maintainers":[{"name":"roberttwang","email":"1183605593@qq.com"}],"homepage":"https://github.com/Tencent/LoopForge#readme","bugs":{"url":"https://github.com/Tencent/LoopForge/issues"},"bin":{"loopforge":"bin/loopforge.mjs"},"dist":{"shasum":"a74230039ae2925768ee7ec06462f8837281cad0","tarball":"https://registry.npmjs.org/loopforge-cli/-/loopforge-cli-0.2.0.tgz","fileCount":400,"integrity":"sha512-Nsu/Mlc1PWOwXQztm/JycTJzcVwbGlbwI6qNvmglWyC406RiRdjmE3zvAUFJn+QAX7COcwH06Z6E12PpF10e9Q==","signatures":[{"sig":"MEUCIQCSEX/wbXREImSD3IH21wZ74JSg9v67h9c4k5SN9BIp7gIgVuqdUJmCvgFrIB00KHjtSgZzDY2MqIAYEQQpYon+G6I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIDytISNP8ctRXpYBDZAg8qGkhj2zyEl/bzF2Ld4xWJ55AiAWS3jQhvdW7NYntDPNx7i12eJ28oStIIqDNbATb6ONDQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/loopforge-cli@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":2536599},"type":"module","engines":{"node":">=20"},"gitHead":"6b3049ca71e035c790af49e823f7d6c905fab126","scripts":{"test":"bash scripts/smoke-npm.sh","pack:check":"npm pack --dry-run"},"_npmUser":{"name":"roberttwang","email":"1183605593@qq.com"},"repository":{"url":"git+https://github.com/Tencent/LoopForge.git","type":"git"},"_npmVersion":"10.9.8","description":"Multi-agent development workflows for CodeBuddy, Codex, Cursor, and Claude Code","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/loopforge-cli_0.2.0_1789526978496_0.8804145613280154","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"loopforge-cli","version":"0.2.1","keywords":["ai-agents","multi-agent","coding-agent","codex","claude-code","cursor","codebuddy"],"license":"MIT","_id":"loopforge-cli@0.2.1","maintainers":[{"name":"roberttwang","email":"1183605593@qq.com"}],"homepage":"https://github.com/Tencent/LoopForge#readme","bugs":{"url":"https://github.com/Tencent/LoopForge/issues"},"bin":{"loopforge":"bin/loopforge.mjs"},"dist":{"shasum":"2ae7ce16a68fbfab3dc170f8746ac57b8307b044","tarball":"https://registry.npmjs.org/loopforge-cli/-/loopforge-cli-0.2.1.tgz","fileCount":400,"integrity":"sha512-g/MRgnfabFMZFKWRE2BfXGnKkqXr13onaOC21KD5wKouKiW6rD4uNMAANvmzVOI+0yfs7CbSVbzndt80urGhsQ==","signatures":[{"sig":"MEUCIAEU+MD42JbOzcMlLOqK9HNrHoy3B0tbY8tsxL0+tTVXAiEA5vLGNFKKvwxz12ftnh2IwPup90PqI7p3HrwtsMBuHm8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQC6hlhDArSc5Nnv4mEGO/3a6eBU8rDbDwFXRdgIXZdSMgIhAN2KPazBFDPGXLuo1ipP7Cm94YRpFtSvX7aLVJ/NmFGQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/loopforge-cli@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":2537602},"type":"module","engines":{"node":">=20"},"gitHead":"285f252f02d3b0a07fab1a9fd1463147afd517b0","scripts":{"test":"bash scripts/smoke-npm.sh","pack:check":"npm pack --dry-run"},"_npmUser":{"name":"roberttwang","email":"1183605593@qq.com"},"repository":{"url":"git+https://github.com/Tencent/LoopForge.git","type":"git"},"_npmVersion":"10.9.8","description":"Multi-agent development workflows for CodeBuddy, Codex, Cursor, and Claude Code","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/loopforge-cli_0.2.1_1789551987722_0.5575494283244582","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"_id":"loopforge-cli@0.2.2","bin":{"loopforge":"bin/loopforge.mjs"},"bugs":{"url":"https://github.com/Tencent/LoopForge/issues"},"dist":{"shasum":"2f2e9ada2124844edd5d16578aab19f866bc5690","tarball":"https://registry.npmjs.org/loopforge-cli/-/loopforge-cli-0.2.2.tgz","fileCount":400,"integrity":"sha512-UfYkaQ7bUFHQ0nKBEEPyvpFqEnmLyiPP3KsARYR+rfApX+rokJbU/0OXonEMT9U0eoQkF4k5k8l6GYscZ5FIJw==","signatures":[{"sig":"MEQCICLhBy/zqNFfPmSA3NBbRjvz8mne3DmbqOjSRb0CmC6GAiA35dJfSlKlA+k3Im66D/WT0T8wMYdgjBUxxxEs4bCqew==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDm10+vGw65alSVnQQkG160SUOlak4wZ4Qb0YO/Q3RB6AIgbY09F5o+P8cxEOR1o9n1dhk2zknNEgICj1HQcOFHzwo="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/loopforge-cli@0.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":2538143},"name":"loopforge-cli","type":"module","engines":{"node":">=20"},"gitHead":"0c7e211f44be30bce3ab0194b924262402e1129f","license":"MIT","scripts":{"test":"bash scripts/smoke-npm.sh","pack:check":"npm pack --dry-run"},"version":"0.2.2","_npmUser":{"name":"roberttwang","email":"1183605593@qq.com"},"homepage":"https://github.com/Tencent/LoopForge#readme","keywords":["ai-agents","multi-agent","coding-agent","codex","claude-code","cursor","codebuddy"],"repository":{"url":"git+https://github.com/Tencent/LoopForge.git","type":"git"},"_npmVersion":"10.9.8","description":"Multi-agent development workflows for CodeBuddy, Codex, Cursor, and Claude Code","directories":{},"maintainers":[{"name":"roberttwang","email":"1183605593@qq.com"}],"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/loopforge-cli_0.2.2_1789552637856_0.5137022771517927"}}},"time":{"created":"2026-07-20T12:05:14.868Z","modified":"2026-09-16T09:57:18.324Z","0.1.0-alpha.1":"2026-07-20T12:05:15.189Z","0.1.0":"2026-09-10T07:54:09.827Z","0.2.0":"2026-09-16T02:49:38.597Z","0.2.1":"2026-09-16T09:46:27.846Z","0.2.2":"2026-09-16T09:57:17.949Z"},"bugs":{"url":"https://github.com/Tencent/LoopForge/issues"},"license":"MIT","homepage":"https://github.com/Tencent/LoopForge#readme","keywords":["ai-agents","multi-agent","coding-agent","codex","claude-code","cursor","codebuddy"],"repository":{"url":"git+https://github.com/Tencent/LoopForge.git","type":"git"},"description":"Multi-agent development workflows for CodeBuddy, Codex, Cursor, and Claude Code","maintainers":[{"name":"roberttwang","email":"1183605593@qq.com"}],"readme":"# LoopForge\n\n[English](README.md) | 简体中文\n\n**让编码 Agent 不只“写出代码”，而是按一套可确认、可审查、可恢复的流程完成交付。**\n\n把一个需求交给编码 Agent 很容易，难的是让它在动手前理解目标，在实现中不偏离范围，并在结束前完成独立审查和测试。任务一旦变长，还会遇到上下文丢失、执行中断，以及最终只剩一份难以追溯的代码变更。\n\nLoopForge 把这些步骤组织成一条完整的软件交付流程。你只需要描述要解决的问题；LoopForge 会根据任务复杂度选择执行方式，推动 Agent 完成需求澄清、方案设计、代码实现、独立审查和测试，并把关键决策与验证结果保存下来。\n\n## 从一句需求到可验收结果\n\n1. **先理解问题**：Agent 调研现有项目，澄清目标、范围和验收标准，而不是立即开始写代码。\n2. **确认边界后再实施**：中大型任务会在你确认目标、范围、排除项、关键决策和验收标准后，再进入设计与实现。\n3. **分工完成交付**：设计、实现、审查和测试由职责独立的 Agent 分阶段完成，减少同一上下文中的自审偏差。\n4. **用证据说明结果**：需求、方案、代码变更、审查意见和测试结果都会落盘，方便检查、复盘和交接。\n5. **中断后继续执行**：流程状态会被保存，下次可以从未完成的阶段继续，不必重新来过。\n\n小改动会走精简的单 Agent 路径，避免为简单任务引入额外流程；中大型任务才会启用完整的多 Agent 协作。\n\n```text\n你的需求\n   │\n   ├─ 小改动 ───────> 理解 → 实现 → 自检 → 交付\n   │\n   └─ 中大型任务 ───> 澄清并确认 → 设计 → 实现 → 独立审查 → 测试 → 交付\n                              │\n                              └── 全程保存状态和产物，可随时恢复\n```\n\n## 快速开始\n\n要求 Node.js 20+ 和 Python 3.8+。\n\n以下命令安装默认的 Classic Edition。不确定选哪一种时，直接使用这一版。\n\n### CodeBuddy\n\n```bash\nnpx -y loopforge-cli@latest install codebuddy\nnpx -y loopforge-cli@latest status codebuddy\n```\n\n安装后启动：\n\n```text\n/start-devflow \"为订单列表增加状态筛选，并补充接口测试\"\n```\n\n### Codex\n\n```bash\nnpx -y loopforge-cli@latest install codex\nnpx -y loopforge-cli@latest status codex\n```\n\n安装后启动：\n\n```text\n$devflow-codex \"为订单列表增加状态筛选，并补充接口测试\"\n```\n\n### Cursor\n\n```bash\nnpx -y loopforge-cli@latest install cursor\nnpx -y loopforge-cli@latest status cursor\n```\n\n安装后启动：\n\n```text\n/start-devflow \"为订单列表增加状态筛选，并补充接口测试\"\n```\n\n### Claude Code\n\n```bash\nnpx -y loopforge-cli@latest install claude\nnpx -y loopforge-cli@latest status claude\n```\n\n安装后启动：\n\n```text\n/start-devflow \"为订单列表增加状态筛选，并补充接口测试\"\n```\n\n如果安装或运行遇到问题，执行环境诊断：\n\n```bash\nnpx -y loopforge-cli@latest doctor\n```\n\n## 你会得到什么\n\n一次任务结束后，你会同时得到代码变更、已确认的需求、技术方案、独立审查意见、测试结果和交付总结。这些过程与结果默认保存在 `artifacts/{task_slug}/`，方便检查、复盘和交接。\n\n<details>\n<summary>查看默认产物目录</summary>\n\n不同 Edition 的个别目录名称可能略有差异。\n\n```text\n01-requirement/   已确认的目标、范围与验收标准\n02-design/        技术方案与执行计划\n03-code/          代码变更与独立审查报告\n04-e2e/           测试结果\n05-knowledge/     可复用的项目知识\nworkflow-summary.md\n```\n\n</details>\n\nClassic 工作流中断后，CodeBuddy、Cursor 和 Claude Code 使用 `/resume-devflow {task_slug}` 恢复，Codex 使用 `$devflow-codex resume {task_slug}`。状态查看、终止和单阶段命令见安装后对应宿主目录中的 README。\n\n## 什么时候适合使用\n\nLoopForge 尤其适合这些任务：\n\n- 需求还比较模糊，需要先把目标和边界讨论清楚；\n- 改动涉及多个模块，希望先形成方案再实施；\n- 需要把实现、审查和测试交给不同角色完成；\n- 任务可能跨越多个会话，需要保留状态并断点续跑；\n- 团队希望留下可检查、可复盘的交付记录。\n\n如果只是一次性的代码补全或非常明确的微小修改，直接使用编码 Agent 通常已经足够；LoopForge 会为进入其工作流的简单任务选择精简路径。\n\n## 使用 Portable Edition\n\n上面的“快速开始”安装的是默认的 Classic Edition，适合大多数用户。如果只希望安装基于 Agent Skills 的可移植工作流，请根据使用的 Coding Agent 选择下面的命令。为避免同一个 Coding Agent 同时加载两套工作流，以及状态和产物相互冲突，LoopForge 在每个项目中只允许为同一 Coding Agent 启用一种 Edition。如需切换，可重新安装并添加 `--force`。\n\n### CodeBuddy\n\n```bash\nnpx -y loopforge-cli@latest skills install codebuddy\n```\n\n安装后使用：\n\n```text\n/devflow \"为订单列表增加状态筛选，并补充接口测试\"\n```\n\n### Codex\n\n```bash\nnpx -y loopforge-cli@latest skills install codex\n```\n\n安装后使用：\n\n```text\n$devflow \"为订单列表增加状态筛选，并补充接口测试\"\n```\n\n### Cursor\n\n```bash\nnpx -y loopforge-cli@latest skills install cursor\n```\n\n安装后使用：\n\n```text\n/devflow \"为订单列表增加状态筛选，并补充接口测试\"\n```\n\n### Claude Code\n\n```bash\nnpx -y loopforge-cli@latest skills install claude\n```\n\n安装后使用：\n\n```text\n/devflow \"为订单列表增加状态筛选，并补充接口测试\"\n```\n\n完整边界和目录说明见 [`EDITIONS.md`](EDITIONS.md)。\n\n## 更新与卸载\n\n如果希望长期使用，可以全局安装 CLI：\n\n```bash\nnpm install --global loopforge-cli\n```\n\n默认 Classic Edition 的维护命令：\n\n```bash\n# CodeBuddy\nloopforge update codebuddy\nloopforge status codebuddy\nloopforge uninstall codebuddy\n\n# Codex\nloopforge update codex\nloopforge status codex\nloopforge uninstall codex\n\n# Cursor\nloopforge update cursor\nloopforge status cursor\nloopforge uninstall cursor\n\n# Claude Code\nloopforge update claude\nloopforge status claude\nloopforge uninstall claude\n```\n\nPortable Edition 的维护命令：\n\n```bash\n# CodeBuddy\nloopforge skills update codebuddy\nloopforge skills status codebuddy\nloopforge skills uninstall codebuddy\n\n# Codex\nloopforge skills update codex\nloopforge skills status codex\nloopforge skills uninstall codex\n\n# Cursor\nloopforge skills update cursor\nloopforge skills status cursor\nloopforge skills uninstall cursor\n\n# Claude Code\nloopforge skills update claude\nloopforge skills status claude\nloopforge skills uninstall claude\n```\n\n安装状态保存在 `.devflow/install-state.json`。检测到用户修改或文件冲突时，更新会停止而不是覆盖。只有在确认要替换冲突文件或切换 Edition 时才使用 `--force`，建议先运行 `loopforge plan` 检查变更。\n\n如果已经克隆本仓库，也可以在仓库根目录从当前源码安装：\n\n```bash\npipx install .\n```\n\n## 可选工具\n\n`tools/tcmcp` 是腾讯云只读 MCP Initializr（Redis、CDB、TDSQL-C、TKE、CLS、COS）。它不包含在 `loopforge install` 或 npm CLI 包中。克隆仓库后：\n\n```bash\ncd tools/tcmcp\n```\n\n再按 [`tools/tcmcp/README.md`](tools/tcmcp/README.md) 启动。云 API 密钥不会写入生成的 zip 或容器镜像，只留在拉取资源或安装 MCP 客户端的本机。LoopForge 打 `vX.Y.Z` tag 发版时会发布 `ghcr.io/tencent/loopforge-tcmcp:<version>`。\n\n## 权限与安全\n\n部分宿主的 Classic 配置会启用自动执行或高权限 Agent 模式。请只在可信项目中使用；安装前可以通过 `loopforge plan codebuddy`、`loopforge plan codex`、`loopforge plan cursor` 或 `loopforge plan claude` 检查将写入的文件。不要把凭据、私有地址或生产运维配置写入工作流模板。\n\n安全问题请参阅 [`SECURITY.md`](SECURITY.md)，并通过 GitHub Security Advisory 私密报告。\n\n## 贡献\n\n欢迎提交 Issue 和 Pull Request。修改工作流前请先阅读 [`CONTRIBUTING.md`](CONTRIBUTING.md) 和仓库中的 `AGENTS.md`。版本变化见 [`CHANGELOG.md`](CHANGELOG.md)。\n\n## 许可证\n\n本项目使用 MIT License。第三方内容见 [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md)。\n","readmeFilename":"README.zh-CN.md"}