Manage AI Agent Loops with Ease

A comprehensive GUI and CLI system for managing autonomous AI coding agents. Run tasks iteratively with automatic commits and GitHub sync.

Features

🖥️

Dark-themed GUI

Modern, easy-on-the-eyes interface built with Electron for managing all your Ralph projects.

📁

Project Browser

Navigate and edit PRD, progress files, and loop scripts with built-in file editor.

💻

Terminal Streaming

Real-time output from running Ralph loops with color-coded logs.

🐙

GitHub Integration

Clone repos, list projects, and manage repositories with gh CLI integration.

🔄

Auto-commit & Sync

Automatic git commits and remote sync between each loop iteration.

⚙️

Background Daemon

Monitors and manages loop processes, restarts on script changes every 5 minutes.

Beautiful Interface

Ralph Manager GUI Screenshot

How It Works

Initialize Project

Create a new Ralph project with PRD, progress file, and prompt template.

Define Tasks

Add tasks to prd.json with descriptions, priorities, and completion criteria.

Start Loop

Click "Start Loop" in the GUI or run the script to begin autonomous execution.

Agent Works

AI agent reads PRD, completes one task, updates files, and commits changes.

Wait & Repeat

Loop waits 5 minutes, then continues to the next task until all are complete.

Done!

When all tasks are complete, creates .ralph-done file and stops.

Quick Start

# Clone the repository
git clone https://github.com/vkumar-dev/ralph-manager.git
cd ralph-manager

# Install dependencies
npm install

# Start the GUI
npm start

# Or use the alias
source ~/.bash_alias
ralph