@ebowwa/ralph-loops

Autonomous AI code iteration with checkpoint-based branches.

Usage

# CLI
ralph start "Fix the authentication bug"
ralph list
ralph stop <loop-id>
ralph checkpoint <loop-id> "Fixed login"

Programmatic

import { RalphService } from '@ebowwa/ralph-loops';

const ralph = new RalphService();

// Start a loop
const loop = await ralph.startLoop({
  prompt: "Implement feature X",
  projectPath: "/path/to/project",
});

// Create checkpoint
await ralph.createCheckpoint(loop.id, "Progress checkpoint");

// Rollback
await ralph.rollback(loop.id, "ralph/abc123/cp-1");

// Create PR
await ralph.createPR(loop.id, "ralph/abc123/cp-2");

Features

• Start/stop Ralph loops
• Checkpoint branches (ralph/{id}/cp-{n})
• Rollback to checkpoints
• Create PRs from checkpoints

Environment

ANTHROPIC_API_KEY=sk-...  # Or use ANTHROPIC_API_KEYS for rolling keys