Can I run multiple Ralph instances simultaneously?

Yes. Because Ralph creates unique git worktrees for each project, you can run multiple loops in parallel across different terminal sessions without file conflicts.

What happens if a story fails quality checks?

Ralph iteratively attempts to implement stories and run quality checks. It will only mark a story as passed and commit the changes once the implementation meets the defined criteria.

How does Ralph handle project dependencies?

Ralph reads the 'dependsOn' field within your JSON PRD files to enforce a strict execution order, ensuring prerequisite modules are fully implemented before dependent projects begin.

How do I monitor Ralph's progress while it runs in the background?

You can monitor the real-time status of the loop by tailing the progress file located within the specific worktree: 'tail -f /.ralph-progress.txt'.

Ralph Autonomous Project Runner

Name: Ralph Autonomous Project Runner
Author: richtabor

byrichtabor

•

Productividad y Flujo de Trabajo

Automates feature implementation by executing structured stories from JSON PRDs using isolated git worktrees and dependency mapping.

Ralph is an autonomous execution engine designed to bridge the gap between planning and implementation. By reading structured requirements from JSON PRD files, Ralph intelligently navigates project dependencies to implement features in the correct order. It utilizes git worktrees to perform development in isolated environments, preventing conflicts with your main working directory. With background execution support and automated quality checks, Ralph allows developers to delegate bulk implementation tasks while maintaining high standards for commits and code quality.

Características Principales

0141 GitHub stars

02Intelligent dependency management and project sequencing

03Isolated git worktree environments for parallel development

04Autonomous story implementation from JSON-based PRD files

05Background execution mode with real-time progress tracking

06Automated git commits and quality assurance checks per story

Casos de Uso

01Managing complex multi-project builds where specific modules must be completed before others.

02Running long-duration development tasks in the background while focusing on other high-level architectural decisions.

03Implementing a backlog of well-defined feature stories without manual intervention.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add richtabor/agent-skills ralph-json-start-loop

For use in Claude.ai and ChatGPT

Características Principales

0141 GitHub stars

02Intelligent dependency management and project sequencing

03Isolated git worktree environments for parallel development

04Autonomous story implementation from JSON-based PRD files

05Background execution mode with real-time progress tracking

06Automated git commits and quality assurance checks per story

Casos de Uso

01Managing complex multi-project builds where specific modules must be completed before others.

02Running long-duration development tasks in the background while focusing on other high-level architectural decisions.

03Implementing a backlog of well-defined feature stories without manual intervention.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add richtabor/agent-skills ralph-json-start-loop

For use in Claude.ai and ChatGPT