open-ralph-wiggum

https://github.com/Th0rgal/ralph-wiggum

[{"step":1,"action":"Install and initialize open-ralph-wiggum in your project directory. Run 'npm install -g open-ralph-wiggum' or use the project-specific installation if preferred.","tip":"Ensure you have Claude Code, Codex, or OpenCode installed and authenticated for full functionality."},{"step":2,"action":"Start an iterative coding loop by typing 'ralph \"[YOUR_PROMPT]\"' in your terminal. Replace [YOUR_PROMPT] with a specific coding task, e.g., 'Refactor the API error handling in /src/utils/errors.js'.","tip":"Be as specific as possible with your initial prompt to get targeted results. Include file paths and desired outcomes."},{"step":3,"action":"Monitor progress with 'ralph status' to see active iterations, completed tasks, and pending actions. Use this to track multi-step refactoring or debugging tasks.","tip":"Check status frequently during long-running tasks to catch errors early. Use 'ralph logs' to review detailed logs if needed."},{"step":4,"action":"Iterate by refining prompts based on Ralph's output. For example, if Ralph suggests changes to /src/utils/errors.js, run 'ralph \"Implement the suggested error handling changes in /src/utils/errors.js and add unit tests.\"'","tip":"Use the output from each iteration as input for the next. Ralph maintains context between iterations, so you can chain prompts naturally."},{"step":5,"action":"Finalize the task by reviewing Ralph's summary output, running local tests, and committing the changes. Use 'ralph \"Final review and cleanup of [TASK].\"' to ensure everything is production-ready.","tip":"Always verify Ralph's changes manually before deploying. Use 'ralph status' to confirm the task is complete and no pending actions remain."}]