Skip to content

ralph-orchestrator

AI Agents & Assistants

A hat‑based orchestration framework that continuously iterates AI agents until a task is complete

Track releases GitHub
Rust Latest v2.9.3 · 26d ago Security brief →

Features

  • Multi‑backend support (Claude Code, Gemini CLI, Codex, etc.)
  • Hat system for specialized personas coordinating via events
  • Backpressure gates to enforce tests, linting, and type checks
  • Persistent memories and task tracking across loops

Recent releases

View all 41 releases →
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.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

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
2,912
Forks
272
Languages
Rust TypeScript Python
Downloads/week
304 ↑47%
NPM Maintainers
1
Contributors
32
View on GitHub View on npm Documentation

Install & Platforms

Install via
npm shell-script cargo

Community & Support

Discord

Similar tools

Team-of-agents, A multi-role SDLC orchestrator for Claude Code
agency-swarm
CLI Agent Orchestrator (CAO)
crewAI
ralph-tui

Beta — feedback welcome: [email protected]