ralph-eats-beads

Community

Autonomous AI loop shipping features overnight.

Authorrawwerks
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill automates an autonomous coding loop by orchestrating Claude agents that pull tasks from bd ready and execute them in parallel tmux subwindows.

Core Features & Use Cases

  • Parallel execution: Spawns multiple subagents to work on separate bd issues in parallel, improving throughput.
  • Plan-driven workflow: Aligns with bd epics and issues, automatically syncing progress and closing tasks when done.
  • Observability: Uses tmux windows for real-time visibility into each subagent's progress and results.
  • Use Case: In a project with many bd-ready tasks, start Ralph to orchestrate 3-5 subagents across tmux windows, each implementing a single issue, then aggregate results automatically.

Quick Start

  1. Ensure bd is initialized with an epic and initial issues.
  2. Generate a plan: scripts/planner.sh requirements.md or create issues manually.
  3. Start the implementation loop: scripts/ralph.sh 25

Dependency Matrix

Required Modules

bdtmuxclaudegit

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: ralph-eats-beads
Download link: https://github.com/rawwerks/ralph-eats-beads/archive/main.zip#ralph-eats-beads

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.