v2.8.0

mikeyobrien/ralph-orchestratorv2.8.0Mar 10, 2026by github-actions[bot]
AI Summary

Introduces the ability to expose Ralph as an MCP server over stdio and adds support for user-scoped default configs. The release also consolidates core presets and improves guidance workflows.
Key Highlights

`ralph mcp serve` command for workspace-scoped MCP server
User-scoped default config discovery and support
TUI update availability notices
Human guidance triggers clean restart request flow
Consolidated core preset set around maintained workflows
New Features

MCP server support
User-scoped config
Clean restart flow
Full Release Notes

## 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

```sh
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

```sh
npm install @ralph-orchestrator/ralph-bench@2.8.0
```

## Download ralph-bench 2.8.0

|  File  | Platform | Checksum |
|--------|----------|----------|
| [ralph-bench-aarch64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-bench-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-bench-aarch64-apple-darwin.tar.xz.sha256) |
| [ralph-bench-x86_64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-bench-x86_64-apple-darwin.tar.xz) | Intel macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-bench-x86_64-apple-darwin.tar.xz.sha256) |
| [ralph-bench-aarch64-unknown-linux-gnu.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-bench-aarch64-unknown-linux-gnu.tar.xz) | ARM64 Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-bench-aarch64-unknown-linux-gnu.tar.xz.sha256) |
| [ralph-bench-x86_64-unknown-linux-gnu.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-bench-x86_64-unknown-linux-gnu.tar.xz) | x64 Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-bench-x86_64-unknown-linux-gnu.tar.xz.sha256) |

# ralph-cli 2.8.0

## Install ralph-cli 2.8.0

### Install prebuilt binaries via shell script

```sh
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

```sh
npm install @ralph-orchestrator/ralph-cli@2.8.0
```

## Download ralph-cli 2.8.0

|  File  | Platform | Checksum |
|--------|----------|----------|
| [ralph-cli-aarch64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-cli-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-cli-aarch64-apple-darwin.tar.xz.sha256) |
| [ralph-cli-x86_64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-cli-x86_64-apple-darwin.tar.xz) | Intel macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-cli-x86_64-apple-darwin.tar.xz.sha256) |
| [ralph-cli-aarch64-unknown-linux-gnu.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-cli-aarch64-unknown-linux-gnu.tar.xz) | ARM64 Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-cli-aarch64-unknown-linux-gnu.tar.xz.sha256) |
| [ralph-cli-x86_64-unknown-linux-gnu.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-cli-x86_64-unknown-linux-gnu.tar.xz) | x64 Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-cli-x86_64-unknown-linux-gnu.tar.xz.sha256) |

# ralph-api 2.8.0

## Install ralph-api 2.8.0

### Install prebuilt binaries via shell script

```sh
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

```sh
npm install @ralph-orchestrator/ralph-api@2.8.0
```

## Download ralph-api 2.8.0

|  File  | Platform | Checksum |
|--------|----------|----------|
| [ralph-api-aarch64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-api-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-api-aarch64-apple-darwin.tar.xz.sha256) |
| [ralph-api-x86_64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-api-x86_64-apple-darwin.tar.xz) | Intel macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-api-x86_64-apple-darwin.tar.xz.sha256) |
| [ralph-api-aarch64-unknown-linux-gnu.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-api-aarch64-unknown-linux-gnu.tar.xz) | ARM64 Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-api-aarch64-unknown-linux-gnu.tar.xz.sha256) |
| [ralph-api-x86_64-unknown-linux-gnu.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-api-x86_64-unknown-linux-gnu.tar.xz) | x64 Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-api-x86_64-unknown-linux-gnu.tar.xz.sha256) |

# ralph-e2e 2.8.0

## Install ralph-e2e 2.8.0

### Install prebuilt binaries via shell script

```sh
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

```sh
npm install @ralph-orchestrator/ralph-e2e@2.8.0
```

## Download ralph-e2e 2.8.0

|  File  | Platform | Checksum |
|--------|----------|----------|
| [ralph-e2e-aarch64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-e2e-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-e2e-aarch64-apple-darwin.tar.xz.sha256) |
| [ralph-e2e-x86_64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-e2e-x86_64-apple-darwin.tar.xz) | Intel macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-e2e-x86_64-apple-darwin.tar.xz.sha256) |
| [ralph-e2e-aarch64-unknown-linux-gnu.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-e2e-aarch64-unknown-linux-gnu.tar.xz) | ARM64 Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-e2e-aarch64-unknown-linux-gnu.tar.xz.sha256) |
| [ralph-e2e-x86_64-unknown-linux-gnu.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-e2e-x86_64-unknown-linux-gnu.tar.xz) | x64 Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0/ralph-e2e-x86_64-unknown-linux-gnu.tar.xz.sha256) |