ralph 0.1.2

A CLI agent harness for running AI coding agents (Codex, Claude, Pi, Gemini)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

#!/bin/bash

# Handle Ctrl+C - kill child processes and exit
cleanup() {
  echo -e "\nInterrupted. Cleaning up..."
  pkill -P $$ 2>/dev/null
  exit 130
}
trap cleanup INT TERM

# Defaults
harness="codex"
model=""
iterations="1"
task="TASK.md"

usage() {
  echo "usage: $0 [-h codex|claude] [-m model] [-n count|inf] [file|prompt]" >&2
  echo "  -h  harness: codex (default) or claude" >&2
  echo "  -m  model: defaults to gpt-5.2-codex or claude-opus-4-5-20251101" >&2
  echo "  -n  iterations: number or 'inf' (default: 1)" >&2
  exit 1
}

# Parse flags
while getopts "h:m:n:" opt; do
  case "$opt" in
    h) harness="$OPTARG" ;;
    m) model="$OPTARG" ;;
    n) iterations="$OPTARG" ;;
    *) usage ;;
  esac
done
shift $((OPTIND - 1))

# Set default models if not specified
if [ -z "$model" ]; then
  case "$harness" in
    codex) model="gpt-5.2-codex" ;;
    claude) model="claude-opus-4-5-20251101" ;;
  esac
fi

# Remaining argument is the task
if [ -n "$1" ]; then
  task="$1"
fi

# Resolve the prompt: if it's a file, read it; otherwise use as string
if [ -f "$task" ]; then
  prompt="$(cat "$task")"
else
  prompt="$task"
fi

run_codex() {
  codex exec -m "$model" -c 'model_reasoning_effort="medium"' -c 'approval_policy="never"' -c 'sandbox_mode="danger-full-access"' "$prompt"
}

run_claude() {
  claude --dangerously-skip-permissions --model "$model" --verbose -p --output-format stream-json "$prompt" 2>&1 | jq -r --unbuffered '
    if .type == "assistant" and .message.content? then
      .message.content
    elif .type == "tool_use" then
      "\n⚡ \(.tool_name // .name) \(.tool_input // .input | tostring | .[0:80])...\n"
    elif .type == "tool_result" then
      "✓ done\n"
    elif .type == "result" and .result? then
      .result
    else
      empty
    end
  ' 2>/dev/null
}

run_harness() {
  case "$harness" in
    codex)
      run_codex
      ;;
    claude)
      run_claude
      ;;
    *)
      echo "Unknown harness: $harness. Use 'codex' or 'claude'." >&2
      exit 1
      ;;
  esac
}

if [ "$iterations" = "inf" ]; then
  while true; do
    run_harness
  done
else
  case "$iterations" in
    ''|*[!0-9]*)
      usage
      ;;
  esac

  i=0
  while [ "$i" -lt "$iterations" ]; do
    run_harness
    i=$((i + 1))
  done
fi