v2.3.0

mikeyobrien/ralph-orchestratorv2.3.0Jan 29, 2026by github-actions[bot]

AI Summary

Major feature release introducing a web dashboard for monitoring orchestration loops and CLI tools for topology visualization, alongside configuration enhancements.

Key Highlights

  • Web Dashboard (Alpha) for monitoring and managing Ralph orchestration loops
  • Hats CLI for topology visualization and AI-powered diagrams
  • Parallel config gate to control worktree spawning
  • Per-hat backend arguments support

New Features

  • Web Dashboard (Alpha)
  • Hats CLI
  • Parallel config gate
  • Per-hat backend args
  • New presets
  • Documentation reorganization

Full Release Notes

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

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

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

## Download ralph-bench 2.3.0

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

# ralph-cli 2.3.0

## Install ralph-cli 2.3.0

### Install prebuilt binaries via shell script

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

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

## Download ralph-cli 2.3.0

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

# ralph-e2e 2.3.0

## Install ralph-e2e 2.3.0

### Install prebuilt binaries via shell script

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

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

## Download ralph-e2e 2.3.0

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