From 7b6f71fa93afe2da6862ef2338174839e68541b4 Mon Sep 17 00:00:00 2001
From: frankbria <frank.bria@gmail.com>
Date: Wed, 27 Aug 2025 16:54:16 -0700
Subject: [PATCH] Add configurable timeout for Claude Code execution

Features added:
- Added --timeout/-t option to set execution timeout in minutes
- Default timeout increased from 10 to 15 minutes
- Validation: timeout must be 1-120 minutes
- Shows timeout in execution start message

Usage examples:
- ralph --monitor                    # 15-minute default timeout
- ralph --monitor --timeout 30      # 30-minute timeout for complex tasks
- ralph --verbose --timeout 5       # 5-minute timeout with progress logs

Benefits:
- Prevents hanging on very complex tasks requiring >15 minutes
- Allows shorter timeouts for simpler tasks to fail faster
- User can adjust based on their specific project complexity
- Clear feedback about configured timeout in logs
---
 ralph_loop.sh | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/ralph_loop.sh b/ralph_loop.sh
index 5914d4f..02be99d 100755
--- a/ralph_loop.sh
+++ b/ralph_loop.sh
@@ -14,6 +14,7 @@ PROGRESS_FILE="progress.json"
 CLAUDE_CODE_CMD="claude"
 MAX_CALLS_PER_HOUR=100  # Adjust based on your plan
 VERBOSE_PROGRESS=false  # Default: no verbose progress updates
+CLAUDE_TIMEOUT_MINUTES=15  # Default: 15 minutes timeout for Claude Code execution
 SLEEP_DURATION=3600     # 1 hour in seconds
 CALL_COUNT_FILE=".call_count"
 TIMESTAMP_FILE=".last_reset"
@@ -298,10 +299,11 @@ execute_claude_code() {
     calls_made=$((calls_made + 1))
     
     log_status "LOOP" "Executing Claude Code (Call $calls_made/$MAX_CALLS_PER_HOUR)"
-    log_status "INFO" "⏳ Starting Claude Code execution... (this may take 30s-5min)"
+    local timeout_seconds=$((CLAUDE_TIMEOUT_MINUTES * 60))
+    log_status "INFO" "⏳ Starting Claude Code execution... (timeout: ${CLAUDE_TIMEOUT_MINUTES}m)"
     
     # Execute Claude Code with the prompt, streaming output
-    if timeout 600s $CLAUDE_CODE_CMD < "$PROMPT_FILE" > "$output_file" 2>&1 & 
+    if timeout ${timeout_seconds}s $CLAUDE_CODE_CMD < "$PROMPT_FILE" > "$output_file" 2>&1 & 
     then
         local claude_pid=$!
         local progress_counter=0
@@ -488,6 +490,7 @@ Options:
     -s, --status        Show current status and exit
     -m, --monitor       Start with tmux session and live monitor (requires tmux)
     -v, --verbose       Show detailed progress updates during execution
+    -t, --timeout MIN   Set Claude Code execution timeout in minutes (default: $CLAUDE_TIMEOUT_MINUTES)
 
 Files created:
     - $LOG_DIR/: All execution logs
@@ -502,6 +505,8 @@ Example workflow:
 Examples:
     $0 --calls 50 --prompt my_prompt.md
     $0 --monitor             # Start with integrated tmux monitoring
+    $0 --monitor --timeout 30   # 30-minute timeout for complex tasks
+    $0 --verbose --timeout 5    # 5-minute timeout with detailed progress
 
 HELPEOF
 }
@@ -538,6 +543,15 @@ while [[ $# -gt 0 ]]; do
             VERBOSE_PROGRESS=true
             shift
             ;;
+        -t|--timeout)
+            if [[ "$2" =~ ^[1-9][0-9]*$ ]] && [[ "$2" -le 120 ]]; then
+                CLAUDE_TIMEOUT_MINUTES="$2"
+            else
+                echo "Error: Timeout must be a positive integer between 1 and 120 minutes"
+                exit 1
+            fi
+            shift 2
+            ;;
         *)
             echo "Unknown option: $1"
             show_help