codex-ralph 0.4.1 → 0.4.3

package/README.md

@@ -17,7 +17,7 @@ CODEX_RALPH_TG_KEY=123456:bot-token
 CODEX_RALPH_TG_CHAT=123456789
 ```
 
-Provide these as environment variables (e.g., when invoking `npx`). Each session generates a UUID and includes it in progress messages.
+Provide these as environment variables (e.g., when invoking `npx`). Each session uses a randomly selected emoji to tag progress messages.
 
 Usage:
 
@@ -31,10 +31,10 @@ Optional flags:
 --max-iterations=10
 ```
 
-Message format:
+Message format (session emoji is chosen randomly from a small fixed set and stays constant for the session):
 
 ```
-🧭 ~<session-uuid>~
+<session emoji>
 📌 <current requirement title>
 🎯 <current index> of <total requirements>
 ```

package/agent/ralph-loop.sh

@@ -11,19 +11,23 @@ ROOT_DIR="$(cd "$(dirname "$SCRIPT_PATH")/.." && pwd)"
 SPRINT_FILE=""
 MAX_ITERATIONS=10
 NOTES_FILE=""
-SESSION_UUID=""
+SESSION_EMOJI=""
+USE_CURSOR_AGENT=false
 
-session_uuid() {
-  if [[ -n "${SESSION_UUID}" ]]; then
-    echo "${SESSION_UUID}"
+session_emoji() {
+  if [[ -n "${SESSION_EMOJI}" ]]; then
+    echo "${SESSION_EMOJI}"
     return
   fi
-  SESSION_UUID="$(python3 - <<PY
-import uuid
-print(uuid.uuid4())
-PY
-)"
-  echo "${SESSION_UUID}"
+  local emoji_pool=(
+    "🧭" "🧩" "🧪" "🛰️" "🪁"
+    "🪐" "🎛️" "🧿" "🧲" "🪄"
+    "🧰" "🪚" "🪝" "🪶" "🧯"
+    "🧵" "🧶" "🧷" "🪙" "🪬"
+  )
+  local index=$((RANDOM % ${#emoji_pool[@]}))
+  SESSION_EMOJI="${emoji_pool[$index]}"
+  echo "${SESSION_EMOJI}"
 }
 
 send_telegram() {
@@ -40,22 +44,26 @@ send_telegram() {
 
 usage() {
   cat <<USAGE
-Usage: ralph-loop SPRINT_PATH [--max-iterations=N]
+Usage: ralph-loop SPRINT_PATH [--max-iterations=N] [--cursor-agent]
 
 Options:
   SPRINT_PATH            Path to the sprint markdown file (required).
   --max-iterations=N     Stop after N iterations (0 = no limit, default 10).
+  --cursor-agent         Use cursor-agent instead of codex (default: disabled).
   -h, --help             Show this help.
 USAGE
 }
 
-session_uuid >/dev/null
+session_emoji >/dev/null
 
 for arg in "$@"; do
   case "$arg" in
     --max-iterations=*)
       MAX_ITERATIONS="${arg#*=}"
       ;;
+    --cursor-agent)
+      USE_CURSOR_AGENT=true
+      ;;
     -h|--help)
       usage
       exit 0
@@ -195,7 +203,8 @@ while true; do
   remaining="$(remaining_count)"
   if [[ "$remaining" == "0" ]]; then
     total="$(total_count)"
-    send_telegram "🧭 `${SESSION_UUID}`"$'\n'"✅ All requirements completed"$'\n'"🎯 ${total} of ${total}"
+    session_marker="$(session_emoji)"
+    send_telegram "${session_marker}"$'\n'"✅ All requirements completed"$'\n'"🎯 ${total} of ${total}"
     echo "All sprint requirements complete."
     echo "<promise>DONE</promise>"
     exit 0
@@ -209,7 +218,8 @@ while true; do
   desc="$(next_description)"
   total="$(total_count)"
   current="$(current_index)"
-  send_telegram "🧭 `${SESSION_UUID}`"$'\n'"📌 ${desc}"$'\n'"🎯 ${current} of ${total}"
+  session_marker="$(session_emoji)"
+  send_telegram "${session_marker}"$'\n'"📌 ${desc}"$'\n'"🎯 ${current} of ${total}"
   echo "Iteration $iteration - next requirement: $desc"
 
   prompt_tmp="$(mktemp)"
@@ -223,7 +233,11 @@ while true; do
     current_item_block
   } > "$prompt_tmp"
 
-  codex exec - < "$prompt_tmp"
+  if [[ "$USE_CURSOR_AGENT" == "true" ]]; then
+    cursor-agent -p < "$prompt_tmp"
+  else
+    codex exec - < "$prompt_tmp"
+  fi
 
   rm -f "$prompt_tmp"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-ralph",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Ralph Loop sprint runner for Codex.",
   "bin": {
     "ralph-loop": "agent/ralph-loop.sh"