v2.10.0

2FastLabs/agent-squadv2.10.0Jun 22, 2026by github-actions[bot]

AI Summary

This release introduces significant new capabilities including Forge CLI backend integration, a file-backed human-in-the-loop mode for the robot, and remote branch publishing for worktree loops. It also adds local file-based hat imports, on-demand TUI iteration buffer exports, and context-window telemetry.

Key Highlights

Added Forge CLI backend integration.
Introduced RObot (human-in-the-loop) RPC domain with a file-backed web mode for human interaction.
Added worktree loops remote review branch publishing with rebase support.
Added local file-based hat imports with import resolution and schema validation.

New Features

Forge CLI backend integration
RObot (human-in-the-loop) RPC domain with file-backed web mode
Worktree loops remote review branch publishing with rebase support
Local file-based hat imports with schema validation
On-demand export of TUI iteration buffers to disk
Context-window utilization telemetry in the TUI

Full Release Notes

## Release Notes

### Added

- Forge CLI backend integration.
- RObot (human-in-the-loop) RPC domain in the control plane, plus a file-backed web mode that drives human interaction through files instead of a live socket.
- Worktree loops can publish remote review branches, with rebase support.
- Local file-based hat imports in preflight, including import resolution and schema validation with imported-file context.
- On-demand export of TUI iteration buffers to disk: `e` exports the current iteration, `E` exports all iterations.
- Context-window utilization telemetry, surfaced in the TUI.

### Changed

- Updated the Pi backend package reference to `@earendil-works/pi-coding-agent`.
- Refreshed agent waves observability documentation and added the hat imports design spec.

### Fixed

- TUI search mode now captures typed query characters instead of leaking them to keybindings (e.g. an `e` in the query no longer triggers export); the `Search:` prompt, `N/M` match counter, and `n`/`N` navigation work again.
- Runtime now requires an explicit completion signal after guidance, preventing premature loop termination.
- Persist loop continue state across iterations.
- Honor per-hat scratchpad configuration in generated instructions.
- Drain ACP terminal output before exit so the final output is no longer truncated.
- Canonicalize Ralph artifact paths to avoid path-mismatch errors.
- Deduplicate MCP tool schemas exposed over the API.

# ralph-bench 2.10.0

## Install ralph-bench 2.10.0

### Install prebuilt binaries via shell script

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

### Install prebuilt binaries into your npm project

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

## Download ralph-bench 2.10.0

|  File  | Platform | Checksum |
|--------|----------|----------|
| [ralph-bench-aarch64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-bench-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.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.10.0/ralph-bench-x86_64-apple-darwin.tar.xz) | Intel macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-bench-x86_64-apple-darwin.tar.xz.sha256) |
| [ralph-bench-aarch64-unknown-linux-musl.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-bench-aarch64-unknown-linux-musl.tar.xz) | ARM64 MUSL Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-bench-aarch64-unknown-linux-musl.tar.xz.sha256) |
| [ralph-bench-x86_64-unknown-linux-musl.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-bench-x86_64-unknown-linux-musl.tar.xz) | x64 MUSL Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-bench-x86_64-unknown-linux-musl.tar.xz.sha256) |

# ralph-cli 2.10.0

## Install ralph-cli 2.10.0

### Install prebuilt binaries via shell script

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

### Install prebuilt binaries into your npm project

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

## Download ralph-cli 2.10.0

|  File  | Platform | Checksum |
|--------|----------|----------|
| [ralph-cli-aarch64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-cli-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.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.10.0/ralph-cli-x86_64-apple-darwin.tar.xz) | Intel macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-cli-x86_64-apple-darwin.tar.xz.sha256) |
| [ralph-cli-aarch64-unknown-linux-musl.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-cli-aarch64-unknown-linux-musl.tar.xz) | ARM64 MUSL Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-cli-aarch64-unknown-linux-musl.tar.xz.sha256) |
| [ralph-cli-x86_64-unknown-linux-musl.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-cli-x86_64-unknown-linux-musl.tar.xz) | x64 MUSL Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-cli-x86_64-unknown-linux-musl.tar.xz.sha256) |

# ralph-api 2.10.0

## Install ralph-api 2.10.0

### Install prebuilt binaries via shell script

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

### Install prebuilt binaries into your npm project

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

## Download ralph-api 2.10.0

|  File  | Platform | Checksum |
|--------|----------|----------|
| [ralph-api-aarch64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-api-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.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.10.0/ralph-api-x86_64-apple-darwin.tar.xz) | Intel macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-api-x86_64-apple-darwin.tar.xz.sha256) |
| [ralph-api-aarch64-unknown-linux-musl.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-api-aarch64-unknown-linux-musl.tar.xz) | ARM64 MUSL Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-api-aarch64-unknown-linux-musl.tar.xz.sha256) |
| [ralph-api-x86_64-unknown-linux-musl.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-api-x86_64-unknown-linux-musl.tar.xz) | x64 MUSL Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-api-x86_64-unknown-linux-musl.tar.xz.sha256) |

# ralph-e2e 2.10.0

## Install ralph-e2e 2.10.0

### Install prebuilt binaries via shell script

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

### Install prebuilt binaries into your npm project

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

## Download ralph-e2e 2.10.0

|  File  | Platform | Checksum |
|--------|----------|----------|
| [ralph-e2e-aarch64-apple-darwin.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-e2e-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.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.10.0/ralph-e2e-x86_64-apple-darwin.tar.xz) | Intel macOS | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-e2e-x86_64-apple-darwin.tar.xz.sha256) |
| [ralph-e2e-aarch64-unknown-linux-musl.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-e2e-aarch64-unknown-linux-musl.tar.xz) | ARM64 MUSL Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-e2e-aarch64-unknown-linux-musl.tar.xz.sha256) |
| [ralph-e2e-x86_64-unknown-linux-musl.tar.xz](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-e2e-x86_64-unknown-linux-musl.tar.xz) | x64 MUSL Linux | [checksum](https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0/ralph-e2e-x86_64-unknown-linux-musl.tar.xz.sha256) |