Ralph Sandbox

A sandbox for experimenting with Ralph - an autonomous coding agent workflow that iteratively implements features from a PRD.

Example Project: Todo CLI

This sandbox contains a Todo CLI application built with Rust, demonstrating the Ralph Loop workflow.

Features

• Add tasks with title, priority (high/medium/low), and optional due date
• List tasks sorted by priority and due date
• Complete tasks by ID
• Delete tasks by ID
• SQLite database with Diesel ORM

Usage

# Build
cargo build --release

# Add a task
./target/release/todo add "Buy groceries" --priority high --due 2026-01-25

# List tasks
./target/release/todo list
./target/release/todo list --all  # Include completed tasks

# Complete a task
./target/release/todo complete 1

# Delete a task
./target/release/todo delete 1

Tech Stack

• Rust (Edition 2024)
• Diesel ORM - Type-safe database operations
• Clap - CLI argument parsing
• SQLite - Embedded database

Project Structure

.
├── src/
│   ├── main.rs           # Entry point
│   ├── cli/              # CLI commands and handlers
│   ├── domain/           # Domain models (Task, Priority)
│   ├── repository/       # Database layer (Diesel)
│   ├── schema.rs         # Diesel table schema
│   └── error.rs          # Error types
├── migrations/           # Diesel migrations
├── tasks/
│   ├── prd.json          # Current PRD
│   ├── progress.txt      # Implementation progress log
│   └── archive/          # Completed PRDs
└── diesel.toml           # Diesel configuration

Running Tests

cargo test

License

This is a sandbox project for experimentation purposes.