@herbcaudill/ralph 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Herb Caudill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# Ralph
+
+Autonomous AI iteration engine for Claude CLI. Ralph runs Claude in a loop to systematically work through your codebase's task list, enabling Claude to tackle work items iteratively.
+
+## Overview
+
+Ralph spawns multiple Claude CLI sessions that:
+
+1. Check project health (build, tests)
+2. Select and work on the highest-priority task
+3. Validate changes with tests
+4. Document progress
+5. Commit changes
+6. Repeat
+
+## Installation
+
+```bash
+pnpm add -D @herbcaudill/ralph
+```
+
+Or use directly with npx:
+
+```bash
+npx @herbcaudill/ralph
+```
+
+## Quick start
+
+1. **Initialize ralph in your project:**
+
+```bash
+npx @herbcaudill/ralph init
+```
+
+This creates a `.ralph/` directory with template files:
+
+- `prompt.md` - Instructions for Claude during each iteration
+- `todo.md` - Your task list
+- `progress.md` - Progress log (auto-updated)
+- `events.log` - Event log (auto-generated)
+
+2. **Customize the workflow:**
+
+Edit `.ralph/prompt.md` to match your project's workflow (build commands, test commands, etc.).
+
+3. **Add tasks:**
+
+Edit `.ralph/todo.md` and add tasks for Claude to work on:
+
+```markdown
+### To do
+
+- [ ] Add user authentication
+- [ ] Fix login form validation
+- [ ] Write tests for auth flow
+
+---
+
+### Done
+```
+
+4. **Run ralph:**
+
+```bash
+npx ralph          # Run 10 iterations (default)
+npx ralph 5        # Run 5 iterations
+```
+
+## Commands
+
+| Command                 | Description                                |
+| ----------------------- | ------------------------------------------ |
+| `ralph`                 | Run 10 iterations (default)                |
+| `ralph <n>`             | Run specified number of iterations         |
+| `ralph init`            | Initialize .ralph directory with templates |
+| `ralph --replay`        | Replay events from `.ralph/events.log`     |
+| `ralph --replay <file>` | Replay events from custom log file         |
+| `ralph --help`          | Show help                                  |
+
+## Configuration
+
+### Template files
+
+**`.ralph/prompt.md`**
+
+Instructions for Claude's workflow. Customize this for your project:
+
+- Build/typecheck commands
+- Test commands
+- Project-specific conventions
+- Commit message style
+
+**`.ralph/todo.md`**
+
+Your task list with priority and completion status. Tasks can be:
+
+- Simple one-liners: `- [ ] Fix header alignment`
+- Detailed descriptions with acceptance criteria
+- Broken down into subtasks
+
+**`.ralph/progress.md`**
+
+Auto-updated log of completed work. Each entry includes:
+
+- What was changed
+- Why it was changed
+- Commit information
+
+**`.ralph/events.log`**
+
+Machine-readable log of all Claude interactions (JSON). Use for debugging or replay.
+
+### Customizing the prompt
+
+The default prompt template checks for build errors and tests, but you should customize it for your project:
+
+```markdown
+Before doing anything, run `npm run typecheck` and `npm test`.
+
+If there are errors: YOUR ONLY TASK IS TO FIX THEM.
+
+If no errors, work on the highest-priority task from @.ralph/todo.md.
+```
+
+Replace with your actual build/test commands (e.g., `pnpm build`, `cargo test`, `pytest`, etc.).
+
+## How it works
+
+Ralph is a thin wrapper around the Claude CLI that:
+
+1. **Spawns Claude CLI** with your project context (prompt, todo, progress files)
+2. **Captures output** as streaming JSON events
+3. **Processes events** to display tool usage (Read, Edit, Bash, etc.) in a readable format
+4. **Logs everything** to `events.log` for replay and debugging
+5. **Detects completion** when Claude outputs `<result>COMPLETE</result>`
+6. **Recursively runs** next iteration until count reached or todo list complete
+
+## Requirements
+
+- **Claude CLI** must be installed and configured
+- **Node.js** 18 or higher
+- Git repository (for commits)
+
+Install Claude CLI:
+
+```bash
+# macOS/Linux
+curl https://claude.com/cli | sh
+
+# Or with Homebrew
+brew install anthropics/tap/claude
+```
+
+Configure Claude CLI:
+
+```bash
+claude auth
+```
+
+## Tips
+
+- **Start with small iteration counts** (3-5) to verify the workflow before running longer sessions
+- **Review progress.md** between runs to understand what changed
+- **Customize prompt.md** for your project's specific needs (build commands, test frameworks, etc.)
+- **Break down complex tasks** into smaller subtasks in todo.md
+- **Let Claude prioritize** by not ordering tasks strictly - Claude will choose what makes sense
+
+## License
+
+MIT
+
+## Author
+
+Herb Caudill

package/bin/ralph.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/index.js').then(m => m.run())

package/dist/cli.d.ts

@@ -0,0 +1,20 @@
+export declare const parseArgs: (args: string[]) => {
+    mode: "help";
+    replayFile?: undefined;
+    iterations?: undefined;
+} | {
+    mode: "init";
+    replayFile?: undefined;
+    iterations?: undefined;
+} | {
+    mode: "replay";
+    replayFile: string;
+    iterations?: undefined;
+} | {
+    mode: "run";
+    iterations: number;
+    replayFile?: undefined;
+};
+export declare const showHelp: () => void;
+export declare const initRalph: () => void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE;;;;;;;;;;;;;;;;CAoBvC,CAAA;AAED,eAAO,MAAM,QAAQ,YAapB,CAAA;AAED,eAAO,MAAM,SAAS,YAkCrB,CAAA"}

package/dist/cli.js

@@ -0,0 +1,66 @@
+import chalk from "chalk";
+import { existsSync, mkdirSync, copyFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export const parseArgs = (args) => {
+    const replayIndex = args.indexOf("--replay");
+    const initIndex = args.indexOf("init");
+    const helpIndex = args.findIndex(a => a === "--help" || a === "-h");
+    if (helpIndex !== -1) {
+        return { mode: "help" };
+    }
+    if (initIndex !== -1) {
+        return { mode: "init" };
+    }
+    if (replayIndex !== -1) {
+        const replayFile = args[replayIndex + 1] || join(process.cwd(), ".ralph", "events.log");
+        return { mode: "replay", replayFile };
+    }
+    const iterations = parseInt(args.find(a => /^\d+$/.test(a)) ?? "", 10) || 10;
+    return { mode: "run", iterations };
+};
+export const showHelp = () => {
+    console.log(chalk.bold("ralph") + " - Autonomous AI iteration engine for Claude CLI\n");
+    console.log(chalk.bold("Usage:"));
+    console.log("  ralph [iterations]        Run ralph for specified iterations (default: 10)");
+    console.log("  ralph init                Initialize .ralph directory with templates");
+    console.log("  ralph --replay [file]     Replay events from log file");
+    console.log("  ralph --help              Show this help message\n");
+    console.log(chalk.bold("Examples:"));
+    console.log("  ralph                     Run 10 iterations");
+    console.log("  ralph 5                   Run 5 iterations");
+    console.log("  ralph init                Create .ralph directory");
+    console.log("  ralph --replay            Replay default log file");
+    console.log("  ralph --replay custom.log Replay custom log file\n");
+};
+export const initRalph = () => {
+    const ralphDir = join(process.cwd(), ".ralph");
+    if (existsSync(ralphDir)) {
+        console.log(chalk.yellow("⚠️  .ralph directory already exists"));
+        console.log(chalk.dim("To reinitialize, remove the directory first: rm -rf .ralph"));
+        return;
+    }
+    console.log(chalk.cyan("Initializing ralph..."));
+    mkdirSync(ralphDir, { recursive: true });
+    // Copy templates from package installation
+    const templatesDir = join(__dirname, "..", "templates");
+    const templates = ["prompt.md", "todo.md", "progress.md"];
+    for (const template of templates) {
+        const src = join(templatesDir, template);
+        const dest = join(ralphDir, template);
+        if (existsSync(src)) {
+            copyFileSync(src, dest);
+            console.log(chalk.green("✓") + ` Created ${chalk.dim(".ralph/" + template)}`);
+        }
+        else {
+            console.error(chalk.red("✗") + ` Template not found: ${template}`);
+        }
+    }
+    console.log(chalk.green("\n✓ Ralph initialized successfully!"));
+    console.log(chalk.dim("\nNext steps:"));
+    console.log(chalk.dim("  1. Customize .ralph/prompt.md with your project's workflow"));
+    console.log(chalk.dim("  2. Add tasks to .ralph/todo.md"));
+    console.log(chalk.dim("  3. Run: ralph\n"));
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare const run: () => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,GAAG,YAuBf,CAAA"}

package/dist/index.js

@@ -0,0 +1,28 @@
+import { replayLog } from "./lib/replayLog.js";
+import { runIteration } from "./lib/runIteration.js";
+import { parseArgs, showHelp, initRalph } from "./cli.js";
+export const run = () => {
+    const args = process.argv.slice(2);
+    const parsed = parseArgs(args);
+    if (parsed.mode === "help") {
+        showHelp();
+        return;
+    }
+    if (parsed.mode === "init") {
+        initRalph();
+        return;
+    }
+    if (parsed.mode === "replay") {
+        replayLog(parsed.replayFile);
+        return;
+    }
+    if (parsed.mode === "run") {
+        runIteration(1, parsed.iterations);
+        return;
+    }
+};
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    run();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzD,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,EAAE;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAE9B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,QAAQ,EAAE,CAAA;QACV,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,SAAS,EAAE,CAAA;QACX,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAC5B,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;QAClC,OAAM;IACR,CAAC;AACH,CAAC,CAAA;AAED,yBAAyB;AACzB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,GAAG,EAAE,CAAA;AACP,CAAC"}

package/dist/lib/outputState.d.ts

@@ -0,0 +1,5 @@
+export declare const outputState: {
+    trailingNewlines: number;
+    needsBlankLineBeforeText: boolean;
+};
+//# sourceMappingURL=outputState.d.ts.map

package/dist/lib/outputState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputState.d.ts","sourceRoot":"","sources":["../../src/lib/outputState.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW;;;CAGvB,CAAA"}

package/dist/lib/outputState.js

@@ -0,0 +1,6 @@
+// Shared state for output formatting
+export const outputState = {
+    trailingNewlines: 2,
+    needsBlankLineBeforeText: false,
+};
+//# sourceMappingURL=outputState.js.map

package/dist/lib/outputState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputState.js","sourceRoot":"","sources":["../../src/lib/outputState.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB,EAAE,CAAC;IACnB,wBAAwB,EAAE,KAAK;CAChC,CAAA"}

package/dist/lib/processEvent.d.ts

@@ -0,0 +1,2 @@
+export declare const processEvent: (event: Record<string, unknown>) => void;
+//# sourceMappingURL=processEvent.d.ts.map

package/dist/lib/processEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processEvent.d.ts","sourceRoot":"","sources":["../../src/lib/processEvent.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAuF1D,CAAA"}

package/dist/lib/processEvent.js

@@ -0,0 +1,100 @@
+import { rel } from "./rel.js";
+import { shortenTempPaths } from "./shortenTempPaths.js";
+import { writeWrappedText } from "./textFormatting.js";
+import { showToolUse } from "./showToolUse.js";
+import { outputState } from "./outputState.js";
+const toolIndent = "  ";
+export const processEvent = (event) => {
+    // Stream text deltas as they come in
+    if (event.type === "stream_event") {
+        const streamEvent = event.event;
+        const delta = streamEvent?.delta;
+        if (delta?.type === "text_delta" && delta.text) {
+            if (outputState.needsBlankLineBeforeText) {
+                process.stdout.write("\n");
+                outputState.trailingNewlines = 2;
+                outputState.needsBlankLineBeforeText = false;
+            }
+            writeWrappedText(delta.text);
+            const match = delta.text.match(/\n+$/);
+            if (match) {
+                outputState.trailingNewlines = Math.min(match[0].length, 2);
+            }
+            else {
+                outputState.trailingNewlines = 0;
+            }
+        }
+    }
+    // Show tool uses
+    if (event.type === "assistant") {
+        const message = event.message;
+        const content = message?.content;
+        if (content) {
+            for (const block of content) {
+                if (block.type === "tool_use") {
+                    const input = block.input;
+                    if (block.name === "Read") {
+                        const filePath = input?.file_path;
+                        if (filePath) {
+                            showToolUse("Read", rel(filePath));
+                        }
+                    }
+                    else if (block.name === "Edit" || block.name === "Write") {
+                        const filePath = input?.file_path;
+                        if (filePath) {
+                            showToolUse(block.name, rel(filePath));
+                        }
+                    }
+                    else if (block.name === "Bash") {
+                        const command = input?.command;
+                        if (command) {
+                            showToolUse("$", shortenTempPaths(command));
+                        }
+                    }
+                    else if (block.name === "Grep") {
+                        const pattern = input?.pattern;
+                        const path = input?.path;
+                        showToolUse("Grep", `${pattern}${path ? ` in ${rel(path)}` : ""}`);
+                    }
+                    else if (block.name === "Glob") {
+                        const pattern = input?.pattern;
+                        const path = input?.path;
+                        showToolUse("Glob", `${pattern}${path ? ` in ${rel(path)}` : ""}`);
+                    }
+                    else if (block.name === "TodoWrite") {
+                        const todos = input?.todos;
+                        if (todos?.length) {
+                            const todoIndent = toolIndent + "    ";
+                            const summary = todos
+                                .map(t => `[${t.status === "completed" ? "x"
+                                : t.status === "in_progress" ? "~"
+                                    : " "}] ${t.content}`)
+                                .join("\n" + todoIndent);
+                            showToolUse("TodoWrite", "\n" + todoIndent + summary);
+                        }
+                        else {
+                            showToolUse("TodoWrite");
+                        }
+                    }
+                    else if (block.name === "WebFetch") {
+                        const url = input?.url;
+                        showToolUse("WebFetch", url);
+                    }
+                    else if (block.name === "WebSearch") {
+                        const query = input?.query;
+                        showToolUse("WebSearch", query);
+                    }
+                    else if (block.name === "Task") {
+                        const description = input?.description;
+                        showToolUse("Task", description);
+                    }
+                    else if (block.name === "Skill") {
+                        const skill = input?.skill;
+                        showToolUse("Skill", skill);
+                    }
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=processEvent.js.map

package/dist/lib/processEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processEvent.js","sourceRoot":"","sources":["../../src/lib/processEvent.ts"],"names":[],"mappings":"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"}

package/dist/lib/rel.d.ts

@@ -0,0 +1,2 @@
+export declare const rel: (path: string) => string;
+//# sourceMappingURL=rel.d.ts.map

package/dist/lib/rel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rel.d.ts","sourceRoot":"","sources":["../../src/lib/rel.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,WAM/B,CAAA"}

package/dist/lib/rel.js

@@ -0,0 +1,10 @@
+import { relative } from "path";
+const cwd = process.cwd();
+export const rel = (path) => {
+    // For temp files, just show the filename
+    if (path.includes("/var/folders/") || path.includes("/tmp/")) {
+        return path.split("/").pop() || path;
+    }
+    return relative(cwd, path) || path;
+};
+//# sourceMappingURL=rel.js.map

package/dist/lib/rel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rel.js","sourceRoot":"","sources":["../../src/lib/rel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAE/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;AAEzB,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE;IAClC,yCAAyC;IACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAA;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAA;AACpC,CAAC,CAAA"}

package/dist/lib/replayLog.d.ts

@@ -0,0 +1,2 @@
+export declare const replayLog: (filePath: string) => void;
+//# sourceMappingURL=replayLog.d.ts.map

package/dist/lib/replayLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replayLog.d.ts","sourceRoot":"","sources":["../../src/lib/replayLog.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,SAiBzC,CAAA"}

package/dist/lib/replayLog.js

@@ -0,0 +1,21 @@
+import chalk from "chalk";
+import { readFileSync } from "fs";
+import { processEvent } from "./processEvent.js";
+export const replayLog = (filePath) => {
+    console.log(chalk.cyan(`Replaying: ${filePath}`));
+    console.log(chalk.dim("─".repeat(40)) + "\n");
+    const content = readFileSync(filePath, "utf-8");
+    // Log file contains pretty-printed JSON objects separated by blank lines
+    const eventStrings = content.split(/\n\n+/).filter(s => s.trim());
+    for (const eventStr of eventStrings) {
+        try {
+            const event = JSON.parse(eventStr);
+            processEvent(event);
+        }
+        catch {
+            // Skip malformed entries
+        }
+    }
+    console.log("\n");
+};
+//# sourceMappingURL=replayLog.js.map

package/dist/lib/replayLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replayLog.js","sourceRoot":"","sources":["../../src/lib/replayLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,EAAE;IAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,EAAE,CAAC,CAAC,CAAA;IACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAE7C,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC/C,yEAAyE;IACzE,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IAEjE,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAClC,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AACnB,CAAC,CAAA"}

package/dist/lib/runIteration.d.ts

@@ -0,0 +1,2 @@
+export declare const runIteration: (i: number, iterations: number) => void;
+//# sourceMappingURL=runIteration.d.ts.map

package/dist/lib/runIteration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runIteration.d.ts","sourceRoot":"","sources":["../../src/lib/runIteration.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,EAAE,YAAY,MAAM,SAyFzD,CAAA"}

package/dist/lib/runIteration.js

@@ -0,0 +1,81 @@
+import chalk from "chalk";
+import { spawn } from "child_process";
+import { appendFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { processEvent } from "./processEvent.js";
+import { flushLine, resetTextState } from "./textFormatting.js";
+const logFile = join(process.cwd(), ".ralph", "events.log");
+export const runIteration = (i, iterations) => {
+    if (i > iterations) {
+        console.log(chalk.green(`Completed ${iterations} iterations.`));
+        return;
+    }
+    console.log(chalk.cyan(`Iteration ${i}`));
+    console.log(chalk.dim("─".repeat(40)) + "\n");
+    // Clear log file at start of each iteration
+    writeFileSync(logFile, "");
+    const child = spawn("claude", [
+        "--permission-mode",
+        "bypassPermissions",
+        "-p",
+        "@.ralph/prompt.md",
+        "@.ralph/todo.md",
+        "@.ralph/progress.md",
+        "--output-format",
+        "stream-json",
+        "--include-partial-messages",
+        "--verbose",
+    ], { stdio: ["inherit", "pipe", "inherit"] });
+    let output = "";
+    let stdoutEnded = false;
+    let closeInfo = null;
+    const handleIterationComplete = () => {
+        if (!stdoutEnded || !closeInfo)
+            return;
+        const { code, signal } = closeInfo;
+        if (code !== 0) {
+            console.error(chalk.red(`Claude exited with code ${code}${signal ? ` (signal: ${signal})` : ""}`));
+            console.error(chalk.yellow("Last 2000 chars of output:"));
+            console.error(chalk.dim(output.slice(-2000)));
+            process.exit(1);
+        }
+        if (output.includes("<result>COMPLETE</result>")) {
+            console.log(chalk.green("Todo list complete, exiting."));
+            process.exit(0);
+        }
+        // Flush any remaining text in the line buffer and reset state
+        flushLine();
+        resetTextState();
+        console.log("\n"); // Add blank lines before next iteration
+        runIteration(i + 1, iterations);
+    };
+    child.stdout.on("data", data => {
+        const chunk = data.toString();
+        for (const line of chunk.split("\n")) {
+            if (!line.trim())
+                continue;
+            try {
+                const event = JSON.parse(line);
+                appendFileSync(logFile, JSON.stringify(event, null, 2) + "\n\n");
+                processEvent(event);
+            }
+            catch {
+                // Incomplete JSON line, ignore
+            }
+        }
+        output += chunk;
+    });
+    child.stdout.on("end", () => {
+        stdoutEnded = true;
+        handleIterationComplete();
+    });
+    child.on("close", (code, signal) => {
+        closeInfo = { code, signal };
+        handleIterationComplete();
+    });
+    child.on("error", error => {
+        console.error(chalk.red("Error running Claude:"), error);
+        process.exit(1);
+    });
+};
+//# sourceMappingURL=runIteration.js.map

package/dist/lib/runIteration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runIteration.js","sourceRoot":"","sources":["../../src/lib/runIteration.ts"],"names":[],"mappings":"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"}

package/dist/lib/shortenTempPaths.d.ts

@@ -0,0 +1,2 @@
+export declare const shortenTempPaths: (text: string) => string;
+//# sourceMappingURL=shortenTempPaths.d.ts.map

package/dist/lib/shortenTempPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortenTempPaths.d.ts","sourceRoot":"","sources":["../../src/lib/shortenTempPaths.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,WAK5C,CAAA"}

package/dist/lib/shortenTempPaths.js

@@ -0,0 +1,7 @@
+export const shortenTempPaths = (text) => {
+    // Replace temp file paths with just the filename
+    return text
+        .replace(/\/var\/folders\/[^\s]+/g, match => match.split("/").pop() || match)
+        .replace(/\/tmp\/[^\s]+/g, match => match.split("/").pop() || match);
+};
+//# sourceMappingURL=shortenTempPaths.js.map

package/dist/lib/shortenTempPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortenTempPaths.js","sourceRoot":"","sources":["../../src/lib/shortenTempPaths.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE;IAC/C,iDAAiD;IACjD,OAAO,IAAI;SACR,OAAO,CAAC,yBAAyB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC;SAC5E,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,CAAA;AACxE,CAAC,CAAA"}

package/dist/lib/showToolUse.d.ts

@@ -0,0 +1,2 @@
+export declare const showToolUse: (name: string, arg?: string) => void;
+//# sourceMappingURL=showToolUse.d.ts.map

package/dist/lib/showToolUse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showToolUse.d.ts","sourceRoot":"","sources":["../../src/lib/showToolUse.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,SAWrD,CAAA"}

package/dist/lib/showToolUse.js

@@ -0,0 +1,17 @@
+import chalk from "chalk";
+import { flushLine, resetTextState } from "./textFormatting.js";
+import { outputState } from "./outputState.js";
+const toolIndent = "  ";
+export const showToolUse = (name, arg) => {
+    flushLine();
+    while (outputState.trailingNewlines < 2) {
+        process.stdout.write("\n");
+        outputState.trailingNewlines++;
+    }
+    const formatted = arg ? `${chalk.blue(name)} ${chalk.dim(arg)}` : chalk.blue(name);
+    console.log(toolIndent + formatted);
+    outputState.trailingNewlines = 1;
+    resetTextState();
+    outputState.needsBlankLineBeforeText = true;
+};
+//# sourceMappingURL=showToolUse.js.map

package/dist/lib/showToolUse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showToolUse.js","sourceRoot":"","sources":["../../src/lib/showToolUse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,MAAM,UAAU,GAAG,IAAI,CAAA;AAEvB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,GAAY,EAAE,EAAE;IACxD,SAAS,EAAE,CAAA;IACX,OAAO,WAAW,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1B,WAAW,CAAC,gBAAgB,EAAE,CAAA;IAChC,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClF,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC,CAAA;IACnC,WAAW,CAAC,gBAAgB,GAAG,CAAC,CAAA;IAChC,cAAc,EAAE,CAAA;IAChB,WAAW,CAAC,wBAAwB,GAAG,IAAI,CAAA;AAC7C,CAAC,CAAA"}

package/dist/lib/textFormatting.d.ts

@@ -0,0 +1,4 @@
+export declare const flushLine: () => void;
+export declare const writeWrappedText: (text: string) => void;
+export declare const resetTextState: () => void;
+//# sourceMappingURL=textFormatting.d.ts.map

package/dist/lib/textFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textFormatting.d.ts","sourceRoot":"","sources":["../../src/lib/textFormatting.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,SAAS,YAwCrB,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,SA4B5C,CAAA;AAED,eAAO,MAAM,cAAc,YAK1B,CAAA"}

package/dist/lib/textFormatting.js

@@ -0,0 +1,94 @@
+import chalk from "chalk";
+const termWidth = process.stdout.columns || 80;
+// Word wrap state for streaming text
+let currentLineLength = 0;
+let lineBuffer = "";
+let inBold = false;
+let inCode = false;
+const formatSegment = (text, bold, code) => {
+    if (code)
+        return chalk.yellow(text);
+    if (bold)
+        return chalk.bold(text);
+    return text;
+};
+export const flushLine = () => {
+    if (!lineBuffer)
+        return;
+    let output = "";
+    let segment = "";
+    let segmentBold = inBold;
+    let segmentCode = inCode;
+    let i = 0;
+    while (i < lineBuffer.length) {
+        if (lineBuffer[i] === "*" && lineBuffer[i + 1] === "*") {
+            // Flush current segment
+            if (segment) {
+                output += formatSegment(segment, segmentBold, segmentCode);
+                segment = "";
+            }
+            inBold = !inBold;
+            segmentBold = inBold;
+            i += 2;
+        }
+        else if (lineBuffer[i] === "`") {
+            // Flush current segment
+            if (segment) {
+                output += formatSegment(segment, segmentBold, segmentCode);
+                segment = "";
+            }
+            inCode = !inCode;
+            segmentCode = inCode;
+            i++;
+        }
+        else {
+            segment += lineBuffer[i];
+            currentLineLength++;
+            i++;
+        }
+    }
+    // Flush remaining segment
+    if (segment) {
+        output += formatSegment(segment, segmentBold, segmentCode);
+    }
+    process.stdout.write(output);
+    lineBuffer = "";
+};
+export const writeWrappedText = (text) => {
+    // Accumulate text, wrap at word boundaries
+    for (const char of text) {
+        if (char === "\n") {
+            flushLine();
+            process.stdout.write("\n");
+            currentLineLength = 0;
+        }
+        else if (char === " " || char === "\t") {
+            lineBuffer += char;
+            // Check if we need to wrap - look for last space to break at
+            const visibleLength = lineBuffer.replace(/\*\*/g, "").replace(/`/g, "").length;
+            if (currentLineLength + visibleLength > termWidth) {
+                // Find last space to break at
+                const lastSpace = lineBuffer.lastIndexOf(" ", lineBuffer.length - 2);
+                if (lastSpace > 0) {
+                    const beforeBreak = lineBuffer.slice(0, lastSpace);
+                    const afterBreak = lineBuffer.slice(lastSpace + 1);
+                    lineBuffer = beforeBreak;
+                    flushLine();
+                    process.stdout.write("\n");
+                    currentLineLength = 0;
+                    lineBuffer = afterBreak;
+                }
+            }
+        }
+        else {
+            lineBuffer += char;
+        }
+    }
+};
+export const resetTextState = () => {
+    currentLineLength = 0;
+    lineBuffer = "";
+    inBold = false;
+    inCode = false;
+};
+//# sourceMappingURL=textFormatting.js.map

package/dist/lib/textFormatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textFormatting.js","sourceRoot":"","sources":["../../src/lib/textFormatting.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@herbcaudill/ralph",
+  "version": "0.1.0",
+  "description": "Autonomous AI iteration engine for Claude CLI",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "ralph": "./bin/ralph.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "claude",
+    "ai",
+    "automation",
+    "cli",
+    "iteration",
+    "autonomous"
+  ],
+  "author": "Herb Caudill",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HerbCaudill/ralph.git"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "tsx": "^4.21.0",
+    "typescript": "~5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/templates/progress.md

@@ -0,0 +1,11 @@
+# Progress Log
+
+This file tracks completed tasks and changes made to the codebase during ralph iterations.
+
+Each entry should include:
+- What was changed
+- Why it was changed
+- Any important notes for future work
+
+---
+

package/templates/prompt.md

@@ -0,0 +1,18 @@
+Before doing anything, check that the project builds successfully. Run your project's build/typecheck commands and tests.
+
+If there are build errors or test failures: YOUR ONLY TASK IS TO FIX THEM.
+
+If there are no build errors or test failures:
+
+In @.ralph/todo.md, find the highest-priority task to work on and work only on that task. This should be the one YOU decide has the highest priority - not necessarily the first one in the list.
+
+ONLY WORK ON A SINGLE TASK. If the task you choose is especially complex, then your task is to break it into subtasks, replace the original task in the todo file, commit the file, and end your turn.
+
+When you complete a task, before committing:
+
+- Check that the project builds successfully and tests pass
+- Where applicable, add tests to validate your changes and confirm that they pass
+- Update the todo list by checking off the completed task and moving it to the "Done" section
+- Append your progress to the @.ralph/progress.md file. Use this to leave a note for the next person working in the codebase
+
+Make one git commit for this task. If, while implementing the task, you notice the todo list is complete, output <result>COMPLETE</result> and exit.

package/templates/todo.md

@@ -0,0 +1,10 @@
+### To do
+
+- [ ] Example task 1
+- [ ] Example task 2
+- [ ] Example task 3
+
+---
+
+### Done
+