@canivel/ralph 0.2.0 → 0.2.1

package/README.md

@@ -10,8 +10,8 @@ Ralph is a minimal, file-based agent loop for autonomous coding. Each iteration
 
 - **First-run agent selection** - Prompted to choose your default agent on first use
 - **`ralph config` command** - Reconfigure your default agent anytime
-- **Improved Claude support** - Direct spawning with proper TTY handling for PRD generation
-- **Better Windows compatibility** - Fixed shell quoting issues
+- **Improved Claude support** - Uses stdin mode (`-p -`) for reliable prompt passing
+- **Better Windows compatibility** - Fixed shell quoting and Python detection
 - **Global config storage** - Settings persist in `~/.ralph/config.json`
 
 ## How It Works
@@ -172,8 +172,8 @@ ralph config
 After running `ralph install`, you can customize behavior in `.agents/ralph/config.sh`:
 
 ```bash
-# Override agent command
-AGENT_CMD="claude -p --dangerously-skip-permissions \"\$(cat {prompt})\""
+# Override agent command (Claude uses stdin mode by default)
+# AGENT_CMD="claude --dangerously-skip-permissions -p -"
 
 # Build settings
 NO_COMMIT=false
@@ -230,9 +230,13 @@ AGENT_OPENCODE_CMD="opencode run --attach http://localhost:4096 \"\$(cat {prompt
 
 ### Custom Agent Commands
 
-Use `{prompt}` placeholder when the agent needs a file path instead of stdin:
+Agents are passed prompts via stdin by default. Use `{prompt}` placeholder when the agent needs a file path instead:
 
 ```bash
+# Stdin mode (default for claude, codex)
+AGENT_CMD="my-agent -"
+
+# File path mode (for agents that require a file)
 AGENT_CMD="my-agent --file {prompt}"
 ```
 

package/bin/ralph

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 const { spawnSync } = require("child_process");
 const fs = require("fs");
 const os = require("os");
@@ -140,14 +140,15 @@ async function promptForDefaultAgent(currentDefault) {
 }
 
 async function ensureFirstRunConfig() {
-  // Skip if not interactive TTY
-  if (!process.stdout.isTTY || !process.stdin.isTTY) return null;
-
+  // Always check config first - return configured agent if available
   const config = loadGlobalConfig();
   if (config.defaultAgent) {
     return config.defaultAgent;
   }
 
+  // Skip prompting if not interactive TTY
+  if (!process.stdout.isTTY || !process.stdin.isTTY) return null;
+
   // First run - prompt for agent selection
   const agent = await promptForDefaultAgent("claude");
   if (agent) {
@@ -752,7 +753,7 @@ async function main() {
     env.PRD_PATH = resolvedPrdPath;
   }
 
-  const result = spawnSync(loopPath, loopArgs, {
+  const result = spawnSync("bash", [loopPath, ...loopArgs], {
     stdio: "inherit",
     env,
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canivel/ralph",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Minimal, file-based agent loop for autonomous coding. Fork with improved Claude support and first-run configuration.",
   "bin": {
     "ralph": "bin/ralph"