ralph.sh

#!/bin/bash

# Ralph Loop for Revamp-Hirn
# Autonomous Claude Code task runner
#
# Usage:
#   ./ralph.sh                    # Default: 10 iterations
#   ./ralph.sh --max 5            # Custom max iterations
#   ./ralph.sh --prompt custom.md # Custom prompt file
#
# Stop anytime with Ctrl+C

set -e

# Configuration
MAX_ITERATIONS=${MAX_ITERATIONS:-10}
SLEEP_BETWEEN=${SLEEP_BETWEEN:-60}  # 60 seconds between iterations
PROMPT_FILE=${PROMPT_FILE:-"PROMPT.md"}
COMPLETION_SIGNAL="RALPH_STATUS: DONE"
LOG_DIR="logs"

# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
NC='\033[0m' # No Color

# Parse arguments
while [[ $# -gt 0 ]]; do
  case $1 in
    --max)
      MAX_ITERATIONS="$2"
      shift 2
      ;;
    --prompt)
      PROMPT_FILE="$2"
      shift 2
      ;;
    --sleep)
      SLEEP_BETWEEN="$2"
      shift 2
      ;;
    --help|-h)
      echo "Ralph Loop for Revamp-Hirn"
      echo ""
      echo "Usage: ./ralph.sh [options]"
      echo ""
      echo "Options:"
      echo "  --max N       Maximum iterations (default: 10)"
      echo "  --prompt FILE Custom prompt file (default: PROMPT.md)"
      echo "  --sleep N     Seconds between iterations (default: 60)"
      echo "  --help        Show this help"
      echo ""
      echo "Environment variables:"
      echo "  MAX_ITERATIONS    Same as --max"
      echo "  SLEEP_BETWEEN     Same as --sleep"
      echo "  PROMPT_FILE       Same as --prompt"
      echo ""
      echo "Completion:"
      echo "  Include 'RALPH_STATUS: DONE' in your PROMPT.md success criteria"
      echo "  Ralph will stop when Claude outputs this signal"
      exit 0
      ;;
    *)
      echo "Unknown option: $1"
      exit 1
      ;;
  esac
done

# Ensure log directory exists
mkdir -p "$LOG_DIR"

# Log file for this session
SESSION_ID="ralph-$(date +%s)-$$"
LOG_FILE="$LOG_DIR/ralph_$(date +%Y-%m-%d_%H-%M-%S).log"

log() {
  local level=$1
  local msg=$2
  local timestamp=$(date '+%Y-%m-%d %H:%M:%S')
  echo "[$timestamp] [$level] $msg" >> "$LOG_FILE"
}

# Check prompt file exists
if [ ! -f "$PROMPT_FILE" ]; then
  echo -e "${RED}Error: Prompt file '$PROMPT_FILE' not found${NC}"
  echo ""
  echo "Create PROMPT.md with your task description. Example:"
  echo ""
  echo "  # Ralph Task"
  echo "  ## Current Task"
  echo "  [Describe your task here]"
  echo ""
  echo "  ## Success Criteria"
  echo "  - [ ] Criterion 1"
  echo "  - [ ] Criterion 2"
  echo ""
  echo "  ## Completion Signal"
  echo "  When done, output: RALPH_STATUS: DONE"
  exit 1
fi

# Read prompt
PROMPT=$(cat "$PROMPT_FILE")

# Check if prompt has been customized
if echo "$PROMPT" | grep -q "\[DESCRIBE YOUR TASK HERE\]"; then
  echo -e "${YELLOW}Warning: PROMPT.md contains placeholder text${NC}"
  echo "Edit PROMPT.md to describe your specific task before running Ralph."
  read -p "Continue anyway? (y/N): " confirm
  if [[ "$confirm" != "y" && "$confirm" != "Y" ]]; then
    exit 0
  fi
fi

# Banner
echo -e "${CYAN}"
echo "╔═══════════════════════════════════════════════════════════╗"
echo "║              RALPH LOOP - Revamp-Hirn                     ║"
echo "╠═══════════════════════════════════════════════════════════╣"
echo "║  Max iterations: $(printf '%-5s' $MAX_ITERATIONS)                                    ║"
echo "║  Sleep between:  $(printf '%-5s' $SLEEP_BETWEEN) seconds                            ║"
echo "║  Prompt file:    $(printf '%-20s' $PROMPT_FILE)                    ║"
echo "║  Log file:       $(printf '%-20s' $(basename $LOG_FILE))        ║"
echo "║                                                           ║"
echo "║  Press Ctrl+C to stop at any time                         ║"
echo "╚═══════════════════════════════════════════════════════════╝"
echo -e "${NC}"

log "SUCCESS" "Ralph loop starting with Claude Code"
log "INFO" "Initialized session tracking (session: $SESSION_ID)"

# Track iterations
iteration=0
start_time=$(date +%s)

# Cleanup on exit
cleanup() {
  end_time=$(date +%s)
  duration=$((end_time - start_time))
  echo ""
  echo -e "${CYAN}═══════════════════════════════════════════════════════════${NC}"
  echo -e "${GREEN}Ralph session complete${NC}"
  echo "  Iterations: $iteration / $MAX_ITERATIONS"
  echo "  Duration: $((duration / 60)) minutes $((duration % 60)) seconds"
  echo "  Log: $LOG_FILE"
  echo -e "${CYAN}═══════════════════════════════════════════════════════════${NC}"
  log "INFO" "Session ended after $iteration iterations ($((duration / 60))m $((duration % 60))s)"
}
trap cleanup EXIT

# Main loop
while [ $iteration -lt $MAX_ITERATIONS ]; do
  iteration=$((iteration + 1))

  echo ""
  echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
  echo -e "${GREEN}Iteration $iteration / $MAX_ITERATIONS${NC} - $(date '+%Y-%m-%d %H:%M:%S')"
  echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
  echo ""

  log "INFO" "Starting iteration $iteration"

  # Run Claude Code with the prompt
  # Using --print to capture output for completion detection
  output=$(claude -p "$PROMPT" 2>&1) || true

  echo "$output"

  # Save output to log
  echo "--- Iteration $iteration output ---" >> "$LOG_FILE"
  echo "$output" >> "$LOG_FILE"
  echo "--- End iteration $iteration ---" >> "$LOG_FILE"

  # Check for completion signal
  if echo "$output" | grep -q "$COMPLETION_SIGNAL"; then
    echo ""
    echo -e "${GREEN}═══════════════════════════════════════════════════════════${NC}"
    echo -e "${GREEN}✓ Task completed! Completion signal detected.${NC}"
    echo -e "${GREEN}═══════════════════════════════════════════════════════════${NC}"
    log "SUCCESS" "Task completed! Completion signal detected."
    break
  fi

  # Check for rate limit messages
  if echo "$output" | grep -qi "rate limit\|too many requests\|usage limit"; then
    echo ""
    echo -e "${YELLOW}Rate limit detected. Waiting 5 minutes...${NC}"
    log "WARNING" "Rate limit detected, waiting 5 minutes"
    sleep 300
  fi

  # Don't sleep after last iteration
  if [ $iteration -lt $MAX_ITERATIONS ]; then
    echo ""
    echo -e "${BLUE}Waiting ${SLEEP_BETWEEN}s before next iteration...${NC}"
    echo -e "${BLUE}(Ctrl+C to stop)${NC}"
    sleep $SLEEP_BETWEEN
  fi
done

# Final status
if [ $iteration -ge $MAX_ITERATIONS ]; then
  echo ""
  echo -e "${YELLOW}═══════════════════════════════════════════════════════════${NC}"
  echo -e "${YELLOW}Max iterations reached. Task may not be complete.${NC}"
  echo -e "${YELLOW}Check progress and run again if needed.${NC}"
  echo -e "${YELLOW}═══════════════════════════════════════════════════════════${NC}"
  log "WARNING" "Max iterations reached without completion"
fi