Ralph

Ralph is an autonomous AI agent loop that runs AI coding tools (Amp, Claude Code, Antigravity, etc.) repeatedly until all PRD items are complete.

  • AI
  • Automation
  • Tools & Utilities
Ralph is an autonomous AI agent loop that runs AI coding tools (Amp, Claude Code, Antigravity, etc.) repeatedly until all PRD items are complete. Each iteration is a fresh instance with clean context. You can configure which agents are executed by setting the AGENT_ACCOUNTS variable and adding multiple API keys for rotation when limits are reached.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

55/100 Fair

Maintained
44last commit 292 days ago
Popular
8722,247 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
1016 GB minimum RAM
Security check
90no serious findings, CI

Availability: platform listings confirmed today, links checked 18 days ago

GitHub stars
22,247
Open issues
75
Last commit
2026-02-02
License
MIT
Activity
stale

Checked 6 days ago - source: GitHub (snarktank/ralph)

Resources & Compatibility

Minimum requirements: 16 GB RAM, 50 GB disk.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install Ralph with npm first Make sure Node.js and npm are installed, then run npm install -g @ralph-orchestrator/ralph-cli. Without this, the ralph command won't exist and you can't start projects or run setup checks. source
  • Add an AI CLI backend Ralph needs at least one AI tool to do the work, so install one like Claude Code with npm install -g @anthropic-ai/claude-code. If that backend is missing, Ralph won't be able to complete tasks. source
  • Check setup with ralph doctor After installing, run ralph doctor to catch missing tools or setup problems before starting. It helps avoid confusing failures later by telling you what Ralph could not find. source
  • Prerequisites Install jq before first use (e.g. brew install jq on macOS). Ralph requires a git repository: memory persists via git history, progress.txt and prd.json. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How can I check for setup problems before starting Ralph?

Run ralph doctor after installing it. It helps you catch missing tools or setup problems before starting.

What should I do if Ralph says the claude command is not found?

Verify that the agent installation is present.

How does Ralph keep state between fresh agent iterations?

Memory persists via git history, progress.txt, and prd.json.

How can I make Amp continue when a story exceeds a single context window?

Add amp.experimental.autoHandoff with context 90 to ~/.config/amp/settings.json. This enables automatic handoff when context fills up.

Answers sourced from github.com, mikeyobrien.github.io, mikeyobrien.github.io

Community

Collected 49 days ago - public community threads