# Ralph GUI

This is a minimal localhost dashboard for Ralph.

It does not execute runs by itself.

It only reads:

- `ralph/state/current_run.json`
- `ralph/state/last_background_run.json`
- `ralph/state/events.jsonl`
- `ralph/state/provider_smoke.json`
- recent folders under `ralph/runs/`

## Start

```powershell
powershell -ExecutionPolicy Bypass -File .\ralph\scripts\Start-RalphDashboard.ps1
```

Default URL:

```text
http://127.0.0.1:8765
```

## What it shows

- current run id, stage and status
- implementer state
- reviewer state
- Codex master state
- fix-pass state
- recent event timeline
- latest run folders and summary excerpts
- last background runner metadata

## Note

The dashboard is intentionally simple.

It is meant to answer:

- who is working right now
- what stage the swarm is in
- whether Codex review already happened
- whether a run completed, failed or stopped
