#!/bin/bash

Ralph Wiggum - Long-running AI agent loop

Usage: ./ralph.sh [—tool amp|claude] [max_iterations]

set -e

Parse arguments

TOOL=“amp” # Default to amp for backwards compatibility MAX_ITERATIONS=10

while [[ $#--gt-0-| -gt 0 ]]; do case$ 1 in —tool) TOOL=“ $2" s hi f t 2;; - - t oo l = *) TOO L = "$ {1#*=}” shift ;; *) # Assume it’s max_iterations if it’s a number if [[ ” $1" =^{[} 0 - 9] +$ ]]; then MAX_ITERATIONS=“$1” fi shift ;; esac done

Validate tool choice

if [[ “ $TOOL" != "amp" && "$ TOOL” != “claude” ]]; then echo “Error: Invalid tool ‘ $TOO L^{'} . M u s t b e^{'} am p^{'} o r^{'} c l a u d e^{'} ." e x i t 1 f i SCR I P T_{D} I R = "$ (cd “ $(d i r nam e "$ {BASH_SOURCE[0]}”)” && pwd)” PRD_FILE=“ $SCR I P T_{D} I R / p r d . j so n " PROGRES S_{F} I L E = "$ SCRIPT_DIR/progress.txt” ARCHIVE_DIR=“ $SCR I P T_{D} I R / a rc hi v e " L A S T_{B} R A NC H_{F} I L E = "$ SCRIPT_DIR/.last-branch”

Archive previous run if branch changed

if [ -f “ $PRD_FILE" ] && [ -f "$ LAST_BRANCH_FILE” ]; then CURRENT_BRANCH= $(j q - r^{'} . b r an c h N am e // e m pt y^{'} "$ PRD_FILE” 2>/dev/null || echo "") LAST_BRANCH= $(c a t "$ LAST_BRANCH_FILE” 2>/dev/null || echo "")

if [ -n “ $CURRENT_BRANCH" ] && [ -n "$ LAST_BRANCH” ] && [ “ $C U RREN T_{B} R A NC H "! = "$ LAST_BRANCH” ]; then # Archive the previous run DATE= $(date +%Y-%m-%d) # Strip "ralph/" prefix from branch name for folder FOLDER_NAME=$ (echo “ $L A S T_{B} R A NC H "∣ se d^{'} s ∣^{r} a lp h /∣ ∣^{'}) A RC H I V E_{F} O L D ER = "$ ARCHIVE_DIR/ $D A TE -$ FOLDER_NAME”

echo "Archiving previous run: $LAST_BRANCH"
mkdir -p "$ARCHIVE_FOLDER"
[ -f "$PRD_FILE" ] && cp "$PRD_FILE" "$ARCHIVE_FOLDER/"
[ -f "$PROGRESS_FILE" ] && cp "$PROGRESS_FILE" "$ARCHIVE_FOLDER/"
echo "   Archived to: $ARCHIVE_FOLDER"

# Reset progress file for new run
echo "# Ralph Progress Log" > "$PROGRESS_FILE"
echo "Started: $(date)" >> "$PROGRESS_FILE"
echo "---" >> "$PROGRESS_FILE"

fi fi

Track current branch

if [ -f “ $PR D_{F} I L E "]; t h e n C U RREN T_{B} R A NC H =$ (jq -r ‘.branchName // empty’ “ $PR D_{F} I L E "2 > / d e v / n u ll ∣∣ ec h o "") i f [- n "$ CURRENT_BRANCH” ]; then echo “ $C U RREN T_{B} R A NC H " > "$ LAST_BRANCH_FILE” fi fi

Initialize progress file if it doesn’t exist

if [ ! -f “ $PROGRESS_FILE" ]; then echo "# Ralph Progress Log" > "$ PROGRESS_FILE” echo “Started: $(d a t e) " >> "$ PROGRESS_FILE” echo ”---” >> “$PROGRESS_FILE” fi

echo “Starting Ralph - Tool: $TOO L - M a x i t er a t i o n s :$ MAX_ITERATIONS”

for i in $(se q 1$ MAX_ITERATIONS); do echo "" echo ”===============================================================” echo ” Ralph Iteration $i o f$ MAX_ITERATIONS ($TOOL)” echo ”===============================================================“

Run the selected tool with the ralph prompt

if [[ “ $TOO L " == " am p "]]; t h e n O U TP U T =$ (cat “ $SCRIPT_DIR/prompt.md" | amp --dangerously-allow-all 2>&1 | tee /dev/stderr) || true else # Claude Code: use --dangerously-skip-permissions for autonomous operation, --print for output OUTPUT=$ (claude —dangerously-skip-permissions —print < “$SCRIPT_DIR/CLAUDE.md” 2>&1 | tee /dev/stderr) || true fi

Check for completion signal

if echo “ $O U TP U T "∣ g re p - q " < p ro mi se > COMP L ETE < / p ro mi se > "; t h e n ec h o "" ec h o " R a lp h co m pl e t e d a llt a s k s! " ec h o " C o m pl e t e d a t i t er a t i o n$ i of $MAX_ITERATIONS” exit 0 fi

echo “Iteration $i complete. Continuing…” sleep 2 done

echo "" echo “Ralph reached max iterations ( $M A X_{I} TER A T I ONS) w i t h o u t co m pl e t in g a llt a s k s ." ec h o " C h ec k$ PROGRESS_FILE for status.” exit 1

My Brain Wiki

探索

snarktank-ralph-ralph-sh-2026