@wavilikhin/ralph-wiggum 0.1.15 → 0.1.17

package/README.md

@@ -3,8 +3,19 @@
 [![npm version](https://img.shields.io/npm/v/@wavilikhin/ralph-wiggum.svg)](https://www.npmjs.com/package/@wavilikhin/ralph-wiggum)
 [![npm publish](https://github.com/wavilikhin/ralph-wiggum/actions/workflows/publish.yml/badge.svg)](https://github.com/wavilikhin/ralph-wiggum/actions/workflows/publish.yml)
 
+```
+  ____       _       _       __        ___                       
+ |  _ \ __ _| |_ __ | |__    \ \      / (_) __ _ _   _ _   _ _ __ 
+ | |_) / _` | | '_ \| '_ \    \ \ /\ / /| |/ _` | | | | | | | '_ \
+ |  _ < (_| | | |_) | | | |    \ V  V / | | (_| | |_| | |_| | | | |
+ |_| \_\__,_|_| .__/|_| |_|     \_/\_/  |_|\__, |\__,_|\__,_|_| |_|
+              |_|                          |___/                   
+```
+
 Ralph Wiggum is a tiny wrapper around the “autonomous loop” pattern: run an AI coding agent repeatedly, but keep each iteration small and strict.
 
+Origin: the [Ralph Wiggum autonomous loop](https://ghuntley.com/ralph/) pattern by Geoffrey Huntley.
+
 Each iteration:
 - starts with fresh context (new process)
 - completes exactly one plan item
@@ -53,7 +64,9 @@ The loop stops when either:
 
 ## Flags
 
-`ralph-wiggum init` scaffolds files. The loop itself is controlled via `.ralph/run.sh`:
+`ralph-wiggum init` scaffolds files. The loop itself is controlled via `.ralph/run.sh`.
+
+Any additional flags are forwarded to `opencode run`.
 
 ```bash
 .ralph/run.sh [options]
@@ -96,6 +109,18 @@ tail -f .ralph/logs/ralph.log
 - Enforces one commit per iteration.
 - Requires a clean working tree after each iteration.
 
+### Permissions
+
+Ralph Wiggum automatically allows `external_directory` permission to prevent OpenCode from blocking the autonomous loop with permission prompts. This setting is merged with your project's `opencode.json` — your other permissions remain intact.
+
+If you need full permissive mode (allow all permissions), set the environment variable before running:
+
+```bash
+OPENCODE_CONFIG_CONTENT='{"permission":"allow"}' .ralph/run.sh
+```
+
+See [OpenCode Permissions](https://opencode.ai/docs/permissions) for details.
+
 <details>
 <summary><strong>AI agent appendix (full detail)</strong></summary>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavilikhin/ralph-wiggum",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Autonomous coding loop for OpenCode - one task, one commit, fresh context per iteration",
   "type": "module",
   "bin": {

package/templates/ralph-loop.sh

@@ -18,6 +18,7 @@ MODEL="${RALPH_MODEL:-anthropic/claude-opus-4-20250514}"
 VARIANT=""
 VERBOSE=false
 LIVE=false
+OPENCODE_ARGS=()
 
 # All ralph files are in .ralph/
 RALPH_DIR="$SCRIPT_DIR"
@@ -214,10 +215,19 @@ while [[ $# -gt 0 ]]; do
             print_usage
             exit 0
             ;;
+        --)
+            shift
+            OPENCODE_ARGS+=("$@")
+            break
+            ;;
         *)
-            log_error "Unknown option: $1"
-            print_usage
-            exit 1
+            if [[ $# -ge 2 && "$2" != -* ]]; then
+                OPENCODE_ARGS+=("$1" "$2")
+                shift 2
+            else
+                OPENCODE_ARGS+=("$1")
+                shift
+            fi
             ;;
     esac
 done
@@ -265,12 +275,18 @@ cd "$REPO_ROOT"
 for i in $(seq 1 "$MAX_ITERATIONS"); do
     ITER_START=$(date +%s)
     ITER_LOG_FILE="$LOGS_DIR/ralph_iter_${i}.log"
+    LIVE_PREFIX="  ${DIM}[LIVE ${i}/${MAX_ITERATIONS}]${NC} "
     
     log_iteration_start "$i" "$MAX_ITERATIONS"
 
     BEFORE_HEAD=$(git rev-parse HEAD)
     log_info "HEAD before: ${DIM}${BEFORE_HEAD:0:8}${NC}"
 
+    # Allow external_directory permission to prevent blocking prompts during autonomous execution.
+    # This merges with (not replaces) any existing opencode.json permissions in the project.
+    # See: https://opencode.ai/docs/permissions
+    export OPENCODE_CONFIG_CONTENT='{"permission":{"external_directory":"allow"}}'
+
     OPENCODE_CMD=(
         opencode run
         --model "$MODEL"
@@ -281,6 +297,10 @@ for i in $(seq 1 "$MAX_ITERATIONS"); do
     if [[ -n "$VARIANT" ]]; then
         OPENCODE_CMD+=(--variant "$VARIANT")
     fi
+
+    if [[ ${#OPENCODE_ARGS[@]} -gt 0 ]]; then
+        OPENCODE_CMD+=("${OPENCODE_ARGS[@]}")
+    fi
     
     OPENCODE_CMD+=("Follow the attached PROMPT.md. Use AGENTS.md for validation commands and IMPLEMENTATION_PLAN.md for task selection. Do exactly one task and one commit.")
 
@@ -291,7 +311,8 @@ for i in $(seq 1 "$MAX_ITERATIONS"); do
     set +e
     if [[ "$LIVE" == true ]]; then
         # Stream to terminal AND write to log file
-        "${OPENCODE_CMD[@]}" 2>&1 | tee "$ITER_LOG_FILE"
+        # Prefix each opencode line so it doesn't visually clash with ralph logs.
+        "${OPENCODE_CMD[@]}" 2>&1 | while IFS= read -r line; do printf '%b%s\n' "$LIVE_PREFIX" "$line"; done | tee "$ITER_LOG_FILE"
         EXIT_CODE=${PIPESTATUS[0]}
         OUTPUT=$(cat "$ITER_LOG_FILE")
     elif [[ "$VERBOSE" == true ]]; then