What it does
Ralph runs Claude Code, Anthropic's AI coding assistant, over and over so it keeps improving a project on its own. It is based on a technique named by developer Geoffrey Huntley.
It includes safeguards to stop the loop when work is finished, when it gets stuck or when it hits usage limits. It limits how many requests it makes per hour.
Other features include live progress views, desktop notifications, backup branches you can roll back to and importing tasks from GitHub issues.
Who it's for
Programmers who use Claude Code and want it to work through bigger tasks with less supervision.
Can I use it without coding?
Developers only. You install it with a script in the terminal and set it up per project. New to this? Start here.
Can I run it?
- Cost
- Free, but needs an AI accountThe software is free, but it uses an online AI service (like OpenAI or Anthropic), which usually charges for use.
- Computer
- An ordinary computer is fine
- Privacy
- Sends what you give it to an online service
- API key
- Not needed
Try it
- Install Claude Code first.
- Download Ralph and run its install script once to add its commands to your computer.
- In your project folder, run its setup wizard, then start the loop.
Using Claude Code, Cursor or another AI coding assistant? Paste the prompt and it will walk you through the setup.New to this?
Before you install
- Only download from the official GitHub page. Copies with similar names exist for many popular projects.
- License (MIT): Very permissive: free to use, change and share, including for business.
- What you type or upload is sent to an online service. Avoid sharing private or sensitive information.
- More on staying safe