Writes ralph loops for you that you can copy and paste

为 Claude Code、Gemini CLI 或 Grok CLI 生成可立即运行的 Shell 循环命令,支持按 AI 工具、模型、Shell、复杂度及循环功能进行自定义。

安装

概览

Ralph 是一个专为 AI 编程助手 CLI 工具设计的自动化循环命令生成器,旨在简化 Claude Code、Gemini CLI 和 Grok CLI 的重复性任务执行流程。用户无需手动编写复杂的 Shell 脚本,只需通过交互式问答回答几个关键问题,即可获得可直接复制粘贴运行的完整循环命令。该工具支持多种主流操作系统(PowerShell、Windows CMD、Bash/Linux)和不同复杂度的控制需求,从基础固定次数循环到高级的时间限制与文件监控机制一应俱全。Ralph 特别强调对 Claude Code 特殊语法的正确处理,确保命令行参数传递无误,避免因管道输入导致的功能失效问题。最终生成的命令会被保存为带时间戳的 Markdown 文件,便于后续查阅与管理。

核心功能特点

  1. 支持 Claude Code、Gemini CLI 和 Grok CLI 三大 AI 编程工具的命令生成
  2. 提供简单、中级、高级三种复杂度级别以满足不同自动化需求
  3. 自动适配 PowerShell、CMD 和 Bash 环境并输出对应语法
  4. 内置时间追踪功能,每次运行后显示执行耗时
  5. 可配置最大迭代次数、运行时间上限及 STOP.txt 停止文件机制
  6. 生成带精确时间戳的文件名,便于版本管理与历史追溯

适用场景

Ralph 特别适合需要反复调用 AI 编程助手进行代码生成或任务迭代的开发者。例如,在优化一个复杂算法时,你可能希望让 Claude Code 多次尝试不同的实现方案,每次基于相同的 PROMPT.md 提示文件,但允许模型根据前一次结果调整策略。使用 Ralph 可以快速生成一个固定运行 10 次的循环命令,每次结束后暂停 5 秒以便观察输出,并记录每轮执行时间。对于长期运行的探索性项目,如自动化测试用例生成或文档补全,可通过设置时间限制(如最多运行 30 分钟)防止无限挂起。此外,当团队协作中有人需手动干预终止进程时,启用 STOP.txt 触发机制即可安全退出,而无需强制中断终端。无论是本地开发、CI/CD 流水线集成还是批量处理任务,Ralph 都能显著提升工作效率并减少人为错误。