ableton-mcp-ai/ralph/gui/README.md

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 -ExecutionPolicy Bypass -File .\ralph\scripts\Start-RalphDashboard.ps1

Default URL:

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