Skip to content

Release history

ralph-orchestrator releases

An improved implementation of the Ralph Wiggum technique for autonomous AI agent orchestration

Back to tool Latest release

All releases

43 shown

No immediate action
v2.10.1 Bug fix

E2E mock-mode fixes + test isolation

Open
No immediate action
v2.10.0 New feature

Forge CLI, Robot RPC, TUI exports

Open
v2.9.3 Maintenance

Minor fixes and improvements.

Full changelog

ralph-bench 2.9.3

Install ralph-bench 2.9.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.9.3/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.9.3

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-musl.tar.xz | ARM64 MUSL Linux | checksum |
| ralph-bench-x86_64-unknown-linux-musl.tar.xz | x64 MUSL Linux | checksum |

ralph-cli 2.9.3

Install ralph-cli 2.9.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.9.3/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.9.3

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-musl.tar.xz | ARM64 MUSL Linux | checksum |
| ralph-cli-x86_64-unknown-linux-musl.tar.xz | x64 MUSL Linux | checksum |

ralph-api 2.9.3

Install ralph-api 2.9.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.9.3/ralph-api-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-api 2.9.3

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-api-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-api-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-api-aarch64-unknown-linux-musl.tar.xz | ARM64 MUSL Linux | checksum |
| ralph-api-x86_64-unknown-linux-musl.tar.xz | x64 MUSL Linux | checksum |

ralph-e2e 2.9.3

Install ralph-e2e 2.9.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.9.3/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.9.3

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-musl.tar.xz | ARM64 MUSL Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-musl.tar.xz | x64 MUSL Linux | checksum |

View release on GitHub
v2.9.2 Bug fix

Fixed Claude TUI blank/stuck output on large prompts by resolving PTY stdin deadlock.

View release on GitHub
v2.9.1 Bug fix

Cargo installation failed because a preview module was improperly included; relocating it to a public dependency resolves the compilation error and enables successful builds.

View release on GitHub
v2.9.0 New feature
Notable features
  • Agent waves for intra-loop parallel hat execution
  • Current branch display in TUI header
  • Richer Copilot JSON stream event handling
Full changelog

Release Notes

Added

  • Agent waves for intra-loop parallel hat execution.
  • Current branch display in the TUI header.
  • Richer Copilot JSON stream event handling.

Changed

  • Improved rich TUI tool output and the end-to-end harness.
  • Shifted coverage and Rust gate validation earlier in CI, with aligned local/GitHub checks.
  • Refreshed documentation links and coverage publishing plumbing.

Fixed

  • TUI mouse toggle behavior.
  • Scratchpad path resolution for loop state.
  • Large prompt handoff for arg-based backends by routing through temp files.
  • CLI executor streaming and inactivity-timeout handling.
  • Self-loop event publishing guidance and backend contract validation coverage.

ralph-bench 2.9.0

Install ralph-bench 2.9.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.9.0/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.9.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.9.0

Install ralph-cli 2.9.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.9.0/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.9.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-api 2.9.0

Install ralph-api 2.9.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.9.0/ralph-api-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-api 2.9.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-api-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-api-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-api-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-api-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.9.0

Install ralph-e2e 2.9.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.9.0/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.9.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.8.1

Minor fixes and improvements.

Full changelog

ralph-bench 2.8.1

Install ralph-bench 2.8.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.1/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.8.1

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.8.1

Install ralph-cli 2.8.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.1/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.8.1

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-api 2.8.1

Install ralph-api 2.8.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.1/ralph-api-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-api 2.8.1

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-api-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-api-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-api-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-api-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.8.1

Install ralph-e2e 2.8.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.1/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.8.1

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.8.0 New feature
Notable features
  • ralph mcp serve for workspace-scoped MCP server exposure
  • User-scoped default config discovery
  • Consolidated and refined preset set
Full changelog

Release Notes

Added

  • ralph mcp serve for exposing Ralph as a workspace-scoped MCP server over stdio.
  • User-scoped default config discovery and support for per-user Ralph defaults.
  • TUI update availability notices in the header.
  • Human guidance can now trigger a clean restart request flow.

Changed

  • Consolidated the core preset set around the maintained workflows and refreshed preset docs, examples, and evaluation tooling.
  • Refined PDD and code-task guidance to reduce Ralph-specific noise and improve handoff quality.

Fixed

  • Hardened multi-hat preset event contracts, late-event recovery, active hat display, and downstream debug/review handoffs.
  • Preserved runtime limits from core config when using hats.
  • Fixed headless loop runner backend selection.
  • Made restart resumption use the required single-command shell flow and added contract coverage for it.

ralph-bench 2.8.0

Install ralph-bench 2.8.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.8.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.8.0

Install ralph-cli 2.8.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.8.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-api 2.8.0

Install ralph-api 2.8.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-api-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-api 2.8.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-api-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-api-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-api-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-api-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.8.0

Install ralph-e2e 2.8.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.8.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.7.0 Breaking risk
Notable features
  • Per-project orchestrator lifecycle hooks v1
  • kiro-acp backend with ACP executor support
  • Subprocess TUI over JSON-RPC stdin/stdout
Full changelog

Release Notes

Added

  • Per-project orchestrator lifecycle hooks v1.
  • kiro-acp backend with ACP executor support.
  • Subprocess TUI over JSON-RPC stdin/stdout.
  • Improved TUI tool rendering for ACP-backed flows.

Changed

  • Simplified internal code paths by removing redundant clones and deduplicating now_ts.
  • Replaced deprecated Duration method usage with from_secs.
  • ralph plan PDD SOP now syncs from the canonical strands-agents/agent-sop upstream source, with a small Ralph-specific loop handoff addendum.
  • Added embedded asset sync, check, and upstream refresh helpers for SOP maintenance.
  • Unified and modernized preset documentation.
  • Added llms.txt map generation and CI validation.
  • Hardened web tsx preflight behavior and added funding metadata.

Fixed

  • Avoid self-lock contention in subprocess TUI mode.
  • Accumulate Pi text deltas into flowing paragraphs in the TUI.
  • Clean up zombie worktree loops more reliably.
  • Fix ACP orphaned processes, garbled TUI output, and missing tool details.
  • Resolve clippy issues and missing struct fields.

ralph-bench 2.7.0

Install ralph-bench 2.7.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.7.0/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.7.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.7.0

Install ralph-cli 2.7.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.7.0/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.7.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-api 2.7.0

Install ralph-api 2.7.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.7.0/ralph-api-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-api 2.7.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-api-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-api-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-api-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-api-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.7.0

Install ralph-e2e 2.7.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.7.0/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.7.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.6.0 New feature
Breaking changes
  • Deprecated project.* config keys now fail fast, requiring migration to core.*
Notable features
  • Migrated control plane and web client to Rust RPC.
  • Added shell completions to the ralph CLI.
  • Introduced fresh-eyes preset with enforced review passes.
View release on GitHub
v2.5.1 Maintenance

New prebuilt binaries for core components are provided for macOS and Linux, enabling easier installation via shell script or npm.

View release on GitHub
v2.5.0

Minor fixes and improvements.

Full changelog

ralph-bench 2.5.0

Install ralph-bench 2.5.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.5.0/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.5.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.5.0

Install ralph-cli 2.5.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.5.0/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.5.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.5.0

Install ralph-e2e 2.5.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.5.0/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.5.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.4.4

Minor fixes and improvements.

Full changelog

ralph-bench 2.4.4

Install ralph-bench 2.4.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.4/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.4.4

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.4.4

Install ralph-cli 2.4.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.4/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.4.4

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.4.4

Install ralph-e2e 2.4.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.4/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.4.4

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.4.3 Maintenance

The release adds installer scripts and prebuilt binaries for macOS and Linux across multiple tools, simplifying automated deployment and ensuring consistent environments.

View release on GitHub
v2.4.2 Breaking risk
Breaking changes
  • LOOP_COMPLETE only accepted as structured JSONL event, not string confabulation
Notable features
  • ralph preflight environment validation command
  • ralph doctor diagnostic command
  • ralph tutorial onboarding
Full changelog

What's Changed in v2.4.2

This release focuses on completion integrity, preflight validation, spec-driven pipeline alignment, and a major KISS cleanup removing ~2,500 lines of dead code and redundant presets.

Highlights

  • 🔒 Loop completion now requires a proper JSONL event — agents can no longer confabulate completion by printing the completion promise string; they must emit it via ralph emit (#141)
  • 🛫 ralph preflight validates your environment before orchestration starts — catches misconfigured backends, dirty git state, and incomplete specs before wasting iterations (#146)
  • 🧹 KISS cleanup across 8 items — removed chaos_mode dead code (~560 LOC), 13 redundant presets, and reduced constraint density in SOPs by 77% (253 → 59 MUSTs) (#146)

Features

  • Completion only via JSONL event: LOOP_COMPLETE is now only accepted as a structured event, preventing agents from confabulating completion (#141)
  • Graceful /stop command: New Telegram /stop and CLI ralph stop for clean loop shutdown via signal file (#141)
  • ralph bot token set: Secure Telegram bot token management with keychain support (#141)
  • ralph preflight: Environment validation (backends, git state, spec completeness) that auto-runs before ralph run (#146)
  • ralph doctor: Diagnostic command to inspect local environment, similar to brew doctor (#146)
  • ralph tutorial: Interactive onboarding for first-time users (#146)
  • ralph skill list: Improved skill discovery across nested directories and parent workspaces (#146)
  • Persistent mode: persistent: true keeps the loop alive after LOOP_COMPLETE for daemon-style orchestration (#146)
  • Self-Healer hat: Five automated recovery strategies (rollback, skip, reduce-scope, fallback, escalate) (#146)
  • Spec acceptance criteria parser & test stub generation: Structured Given/When/Then extraction with 1:1 test stub mapping for TDD automation (#146)
  • Spec verification backpressure gate: Blocks build.done when spec acceptance criteria aren't satisfied by passing tests (#146)
  • New backpressure gates: cargo audit, coverage, verifier quality, and performance regression (#146)
  • extra_instructions config: YAML anchors for sharing instruction blocks across hats (#146)
  • Separate human_pending queue: Human-in-the-loop events get their own EventBus queue, preventing message drops during busy iterations (#146)
  • TUI shows max iterations: Header displays [iter 3/50] for operator visibility (#146)
  • --yolo flag for Codex adapter: Enables unattended Codex operation (#146)
  • Session recorder behind feature flag: recording feature gate reduces default binary size (#146)

Fixes

  • Fix human.interact event file resolution: wait_for_response() now reads from the current-events marker instead of hardcoded events.jsonl, fixing responses never being received (#146)
  • Fix wide character rendering in TUI: ContentPane now uses unicode-width for proper emoji/CJK display (#146)
  • Preserve TUI iteration buffers across task.start: No longer wipes output history and iteration count on task reset (#146)
  • Fix UTF-8 boundary truncation: Content truncation no longer splits multi-byte characters (#146)
  • Fix nested skill discovery: Skills in nested directories and parent workspaces are now found correctly (#146)
  • Allow partial merge queue ID resolution: ralph loops merge accepts prefix matches (#146)
  • Drain PTY output after exit: Last lines of agent output in TUI mode are no longer lost (#146)
  • Resolve 26 clippy warnings: Accumulated pedantic warnings cleaned up across workspace (#146)

Documentation

  • Fix .agent/ paths to .ralph/agent/ in concept docs (#144) — thanks @Ahmed-Abdalla-Abdelrehim!
  • Rename interact.human → human.interact for naming consistency (#146)
  • Updated installation guide, getting started tutorial, and backend configuration docs (#146)
  • Added Rust code examples to API reference docs (#146)
  • Added GitHub issue templates (#146)

Refactors & Cleanup

  • Remove chaos_mode dead code (~560 LOC across 10 files) (#146)
  • Remove 13 redundant presets, slimming from 27 to 14 core presets (#146)
  • Decouple telegram from core via RobotService trait in ralph-proto, enabling future Slack/Discord backends (#146)
  • Consolidate ralph-loop + ralph-diagnostics into single ralph-operations skill (-318 LOC) (#146)
  • Unify TDD skills into single test-driven-development skill with 3 input modes (-240 LOC) (#146)
  • Remove unused ralph-adapters dep from ralph-tui (#146)
  • Reduce SOP constraint density by 77% (code-assist: 111→32, PDD: 85→19, code-task-generator: 57→8 MUSTs) (#146)

Testing

  • Massive test coverage expansion: 20+ test commits adding integration tests for preflight, run, presets, skills, tasks, web, and more (#146)

Full Changelog: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.4.1...v2.4.2

ralph-bench 2.4.2

Install ralph-bench 2.4.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.2/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.4.2

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.4.2

Install ralph-cli 2.4.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.2/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.4.2

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.4.2

Install ralph-e2e 2.4.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.2/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.4.2

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.4.1

Minor fixes and improvements.

Full changelog

ralph-bench 2.4.1

Install ralph-bench 2.4.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.1/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.4.1

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.4.1

Install ralph-cli 2.4.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.1/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.4.1

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.4.1

Install ralph-e2e 2.4.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.1/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.4.1

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.4.0

Minor fixes and improvements.

Full changelog

ralph-bench 2.4.0

Install ralph-bench 2.4.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.0/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.4.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.4.0

Install ralph-cli 2.4.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.0/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.4.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.4.0

Install ralph-e2e 2.4.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.4.0/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.4.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.3.1 Maintenance

New prebuilt binaries released for three utilities, adding ARM64 and x86_64 support across macOS and Linux.

View release on GitHub
v2.3.0 New feature
Notable features
  • Web Dashboard with React frontend and Fastify backend
  • Hats CLI topology visualization
  • Parallel config gate for worktree spawning
Full changelog

Release Notes

Added

  • Web Dashboard (Alpha): Full-featured web UI for monitoring and managing Ralph orchestration loops
    • React + Vite + TailwindCSS frontend with Fastify + tRPC + SQLite backend
    • ralph web command to launch both servers (backend:3000, frontend:5173)
    • Preflight checks and auto-install for fresh installs
    • Port conflict detection, labeled output, and automatic browser open
    • Node 22 pinned for backend dev with tsc+node compilation
  • Hats CLI: Topology visualization and AI-powered diagrams (ralph hats)
  • Event Publishing Guide: Skip topology display when a hat is already active
  • Parallel config gate: features.parallel config option to control worktree spawning
  • Per-hat backend args: args support in hat-level backend configurations
  • New presets: Additional presets and improved workflow patterns
  • Documentation: Reorganized docs with governance files and enhanced README

Fixed

  • Honor hat-level backend configuration and args overrides
  • Backend dev workflow uses tsc+node instead of ts-node

ralph-bench 2.3.0

Install ralph-bench 2.3.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.3.0/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.3.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.3.0

Install ralph-cli 2.3.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.3.0/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.3.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.3.0

Install ralph-e2e 2.3.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.3.0/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.3.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.2.5

Minor fixes and improvements.

Full changelog

ralph-bench 2.2.5

Install ralph-bench 2.2.5

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.5/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.2.5

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.2.5

Install ralph-cli 2.2.5

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.5/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.2.5

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.2.5

Install ralph-e2e 2.2.5

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.5/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.2.5

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.2.4

Minor fixes and improvements.

Full changelog

ralph-bench 2.2.4

Install ralph-bench 2.2.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.4/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.2.4

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.2.4

Install ralph-cli 2.2.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.4/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.2.4

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.2.4

Install ralph-e2e 2.2.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.4/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.2.4

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.2.3

Minor fixes and improvements.

Full changelog

ralph-bench 2.2.3

Install ralph-bench 2.2.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.3/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.2.3

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.2.3

Install ralph-cli 2.2.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.3/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.2.3

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.2.3

Install ralph-e2e 2.2.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.3/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.2.3

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.2.2 Maintenance

The release adds official prebuilt installers and checksum files for orchestration, CLI, and e2e components on macOS and Linux, simplifying deployment and verification.

View release on GitHub
v2.2.1 Maintenance

New prebuilt installers and platform‑specific binaries for benchmark, command‑line interface, and end‑to‑end tools were added, expanding supported macOS and Linux architectures and simplifying deployment.

View release on GitHub
v2.2.0

Minor fixes and improvements.

Full changelog

ralph-bench 2.2.0

Install ralph-bench 2.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.0/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.2.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.2.0

Install ralph-cli 2.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.0/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.2.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-e2e 2.2.0

Install ralph-e2e 2.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.2.0/ralph-e2e-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-e2e 2.2.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-e2e-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-e2e-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-e2e-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-e2e-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.1.3

Minor fixes and improvements.

Full changelog

ralph-bench 2.1.3

Install ralph-bench 2.1.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.1.3/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.1.3

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.1.3

Install ralph-cli 2.1.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.1.3/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.1.3

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.1.2

Minor fixes and improvements.

Full changelog

ralph-bench 2.1.2

Install ralph-bench 2.1.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.1.2/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.1.2

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.1.2

Install ralph-cli 2.1.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.1.2/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.1.2

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.1.1 Bug fix

Enhanced TUI streaming with smoother auto-scroll and refined footer; header now reports per-iteration elapsed time, improving real-time monitoring accuracy and user workflow

View release on GitHub
v2.1.0 Breaking risk
Notable features
  • Iteration-based TUI model with snapshot testing
  • Iteration switcher to review previous iterations
  • Soft-wrap at viewport boundaries instead of truncation
Full changelog

What's New in v2.1.0

Added

  • TUI Iteration Architecture: Refactored TUI to iteration-based model with snapshot testing
    • Each iteration gets its own buffer for clean separation
    • Iteration switcher (←/→ arrows) to review previous iterations
    • Snapshot-based testing for TUI components

Fixed

  • TUI Content Display: Removed ellipsis truncation that was cutting off content mid-word
    • Long lines now soft-wrap at viewport boundaries instead of being truncated with "..."
  • TUI Autoscroll: Content now autoscrolls to keep latest output visible
  • TUI Artifacts: Fixed viewport buffer clearing to prevent visual artifacts when switching iterations
  • Markdown Boundaries: Preserved line boundaries when rendering markdown content
  • Backend Support: Added opencode and copilot to valid backends for ralph init (#75, #77)
  • Interrupt Handling: Fixed Ctrl+C race condition where process continued executing after interrupt (#76)

ralph-bench 2.1.0

Install ralph-bench 2.1.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.1.0/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.1.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-cli 2.1.0

Install ralph-cli 2.1.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.1.0/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.1.0

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.0.10

Minor fixes and improvements.

Full changelog

ralph-cli 2.0.10

Install ralph-cli 2.0.10

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.0.10/ralph-cli-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-cli 2.0.10

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

ralph-bench 2.0.10

Install ralph-bench 2.0.10

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.0.10/ralph-bench-installer.sh | sh

Install prebuilt binaries into your npm project

npm install @ralph-orchestrator/[email protected]

Download ralph-bench 2.0.10

| File | Platform | Checksum |
|--------|----------|----------|
| ralph-bench-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| ralph-bench-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| ralph-bench-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| ralph-bench-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |

View release on GitHub
v2.0.9 New feature
Notable features
  • OpenCode CLI backend as 7th supported backend
  • Autonomous mode with --dangerously-skip-permissions flag
  • Full TUI and interactive mode support
Full changelog

What's Changed

  • feat(adapters): add OpenCode CLI backend support by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/67

New Backend: OpenCode

OpenCode is now the 7th supported CLI backend, joining Claude, Kiro, Gemini, Codex, Amp, and Copilot.

cli:
  backend: opencode

Features:

  • --dangerously-skip-permissions for autonomous mode
  • -p flag for prompt passing
  • Full TUI and interactive mode support
  • Auto-detection when installed

Installation

# Via cargo
cargo install ralph-cli

# Via npm
npm install -g @ralph-orchestrator/ralph

# Via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.0.9/ralph-cli-installer.sh | sh

Full Changelog: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.0.8...v2.0.9

View release on GitHub
v2.0.8 New feature
Notable features
  • ralph plan command for PDD planning sessions
  • ralph task command for code task generation
  • GitHub Copilot CLI backend support
Full changelog

What's Changed

  • feat: add ralph plan and ralph task commands for SOP-driven sessions by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/63
  • feat(adapters): add GitHub Copilot CLI backend support by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/64

New Commands

# Start an interactive PDD planning session
ralph plan "build a REST API"

# Generate code task files from descriptions  
ralph task "add authentication"

New Backend: Copilot CLI

GitHub Copilot CLI is now supported as a backend:

cli:
  backend: copilot

Installation

cargo install ralph-cli
# or
npm install -g @ralph-orchestrator/ralph

Full Changelog: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.0.7...v2.0.8

View release on GitHub
v2.0.7 Bug fix
Notable features
  • release-bump skill for repeatable version bumps
Full changelog

What's Changed

  • feat: add release-bump skill for repeatable version bumps
  • fix: include presets in published crate for cargo install
  • docs: fix CI badge and npm package name

Bug Fix

Presets were missing from cargo install ralph-cli — now properly included in the published crate.

Full Changelog: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.0.5...v2.0.7

View release on GitHub
v2.0.5 Bug fix

The release workflow now uses Node.js 24.x, fixing outdated runtime references and ensuring compatibility with newer Node features.

View release on GitHub
v2.0.4 Bug fix

Added a secure npm environment to enable OIDC-based publishing, fixing CI trust issues.

View release on GitHub
v2.0.3 Maintenance
Notable features
  • OIDC trusted publishing
Full changelog

What's Changed

  • fix(ci): only publish ralph-cli to npm — Skip ralph-bench from npm publishing
  • feat(ci): switch npm publishing to OIDC trusted publishing — More secure token-free publishing

Full Changelog: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.0.2...v2.0.3

View release on GitHub
v2.0.2 Bug fix

Added explicit version requirements to internal crate dependencies to enable proper crates.io publishing.

View release on GitHub
v2.0.1 Bug fix

Fixed the npm package glob pattern in the release workflow to ensure correct npm package publishing during the release process.

View release on GitHub
v2.0.0 Breaking risk
⚠ Upgrade required
  • Use 'pip uninstall ralph-orchestrator' to remove the Python version
  • Configuration format has changed; refer to the migration guide for migration instructions
Breaking changes
  • Configuration format changed
  • Python version is deprecated
Notable features
  • Rust-based single binary distribution
  • Hat-Based Architecture using specialized personas
  • 20+ pre-configured workflow presets
View release on GitHub
v1.2.3 New feature
Notable features
  • ACP agent profiles and Gemini-specific handling
  • Default completion promise
Full changelog

What's Changed

  • docs: Add uv tool installation instructions by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/35
  • refactor(adapters): Move scratchpad instructions to base adapter by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/37
  • feat: add default completion promise by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/38
  • Improve ACP tool call visibility by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/41
  • fix: correct agent validation in _apply_codex_shortcut by @CoderMageFox in https://github.com/mikeyobrien/ralph-orchestrator/pull/42
  • Add ACP agent profiles and Gemini-specific handling by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/43
  • fix(completion-detection): detect completion string by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/49
  • release/v1.2.3 by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/56

New Contributors

  • @CoderMageFox made their first contribution in https://github.com/mikeyobrien/ralph-orchestrator/pull/42

Full Changelog: https://github.com/mikeyobrien/ralph-orchestrator/compare/v1.2.2...v1.2.3

View release on GitHub
v1.2.2 New feature
Notable features
  • Kiro CLI Integration successor to Q Chat
  • Completion Marker Detection
  • Loop Detection with rapidfuzz
Full changelog

[1.2.2] - 2026-01-08

Added

  • Kiro CLI Integration: Successor to Q Chat CLI support
    • Full support for kiro-cli chat command
    • Automatic fallback to legacy q command if Kiro is not found
    • Configurable via kiro adapter settings
    • Preserves all Q Chat functionality with new branding
  • Completion Marker Detection: Task can now signal completion via - [x] TASK_COMPLETE checkbox marker in prompt file
    • Orchestrator checks for marker before each iteration
    • Immediately exits loop when marker is found
    • Supports both - [x] TASK_COMPLETE and [x] TASK_COMPLETE formats
  • Loop Detection: Automatic detection of repetitive agent outputs using rapidfuzz
    • Compares current output against last 5 outputs
    • Uses 90% similarity threshold to detect loops
    • Prevents infinite loops from runaway agents
  • New dependency: rapidfuzz>=3.0.0,<4.0.0 for fast fuzzy string matching
  • Documentation static site with MkDocs
  • Comprehensive API reference documentation
  • Additional example scenarios
  • Performance monitoring tools

Changed

  • Improved error handling in agent execution
  • Enhanced checkpoint creation logic
  • SafetyGuard.reset() now also clears loop detection history

Fixed

  • Race condition in state file updates
  • Memory leak in long-running sessions
View release on GitHub
v1.2.0 New feature
Notable features
  • ACP adapter for CLI agents
  • Completion marker detection
  • Loop prevention with rapidfuzz
Full changelog

Initial release

What's Changed

  • Upgrade to claude-agent-sdk and add max_buffer_size support by @odinho in https://github.com/mikeyobrien/ralph-orchestrator/pull/1
  • feat: add production-ready features with async logging, security, and Rich output by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/2
  • fix: Bug fixes, linting improvements, and async I/O corrections by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/4
  • feat(acp): Add ACP (Agent Communication Protocol) adapter for CLI agents by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/5
  • feat: add completion marker detection and loop prevention by @terrylica in https://github.com/mikeyobrien/ralph-orchestrator/pull/6
  • docs: add ASCII architecture diagrams for completion detection and loop prevention by @terrylica in https://github.com/mikeyobrien/ralph-orchestrator/pull/7
  • feat(telemetry): Add per-iteration telemetry capture by @sachafaust in https://github.com/mikeyobrien/ralph-orchestrator/pull/9
  • fix(core): resolve test failures and linting issues by @mikeyobrien in https://github.com/mikeyobrien/ralph-orchestrator/pull/10
  • feat: codex-acp support, agent priority, and ralph.yml auto-load by @jnyross in https://github.com/mikeyobrien/ralph-orchestrator/pull/22

New Contributors

  • @odinho made their first contribution in https://github.com/mikeyobrien/ralph-orchestrator/pull/1
  • @mikeyobrien made their first contribution in https://github.com/mikeyobrien/ralph-orchestrator/pull/2
  • @terrylica made their first contribution in https://github.com/mikeyobrien/ralph-orchestrator/pull/6
  • @sachafaust made their first contribution in https://github.com/mikeyobrien/ralph-orchestrator/pull/9
  • @jnyross made their first contribution in https://github.com/mikeyobrien/ralph-orchestrator/pull/22

Full Changelog: https://github.com/mikeyobrien/ralph-orchestrator/commits/v1.2.0

View release on GitHub

Beta — feedback welcome: [email protected]