Wiggum CLI 是一款开源自主编程智能体，以命令行工具形式工作，可接入任意已有代码库。其核心理念是「从待办到合并 PR」的自动化：扫描技术栈、通过 AI 访谈生成规格说明、再以 Ralph 循环自主完成任务。
主要能力
-
代码库扫描（init）：将 Wiggum 指向任意项目，它会梳理技术栈、项目结构与代码约定，无需配置即可生成用于后续规格与循环的上下文。官方称已用于 TypeScript、Python、Go、Rust、React、Next.js、Astro、Django、Rails 等多种语言与框架。
-
AI 访谈生成规格（new）：用自然语言描述需求，Wiggum 会基于完整代码库上下文对你进行访谈，然后生成详细、可直接实现的规格说明，规格与具体智能体无关，可被任何 CLI 编程智能体执行。
-
自主执行循环（run）：将规格交给编程智能体后，Ralph 循环会以带检查点的自主迭代方式运行，实时跟踪进度，直至功能完成。该循环由 Geoffrey Huntley 提出，将功能开发拆分为规划、实现、端到端测试、验证、PR 审查等阶段，每个阶段作为带检查点的自主智能体循环运行。
-
Agent 模式（wiggum agent）：读取 GitHub 待办事项，按标签优先级（P0 > P1 > P2）与依赖顺序排序，跳过已完成工作、恢复部分分支，为每个 issue 生成规格、运行完整 Ralph 循环、对照规格审查差异，并在所有检查通过时自动合并，然后处理下一个 issue。可在 CI 中以 headless 方式运行（wiggum agent --stream）。
使用方式
通过 npm 全局安装：npm install -g wiggum-cli。随后使用三个命令：wiggum init 扫描代码库；wiggum new 通过 AI 访谈生成规格；wiggum run 用 Claude Code 执行 Ralph 循环。也可用 /issue 浏览 GitHub issue 并带入完整上下文，或直接向 wiggum new 传入 --issue #42。
兼容性
Wiggum 可与任意 CLI 编程智能体配合，官方测试过 Claude Code（Anthropic）、OpenAI Codex CLI，也适用于 Gemini CLI、OpenCode 等终端 AI 助手。
收费与部署
CLI 开源且永久免费，用户自带 API 密钥（如 Anthropic、OpenAI）并在本地运行。官方提到 Pro 计划（$19/月起）将提供托管 API 密钥、Web 仪表板、推送通知与优先支持，但 Web 仪表板、推送通知、托管 API 密钥尚未发布，仅在公开路线图中，可在定价页加入等待列表。
适用场景
适合希望自动化处理已有代码库功能开发、清理 GitHub 待办的开发者与团队；可与 Copilot、Cursor 等编辑器内补全工具互补——后者负责编辑器内补全，Wiggum 在功能层面生成完整规格并运行多步自主循环。
限制
Pro 相关功能暂未提供；实际的 API 密钥、费用与运行环境由用户自行承担；具体各语言支持效果与运行细节以官方文档与实测为准。
