docs: document dashboard keyboard shortcuts and history API endpoint so users discover Cmd+S saving and can query run history programmatically

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: 2 people

docs/changelog.md

@@ -24,6 +24,8 @@ All notable changes to ralphify are documented here.
 - **Contributor docs** — new `docs/contributing/` section with a codebase map, replacing the old `agent_docs/` directory.
 - **Iterations API endpoint** — `GET /api/runs/{run_id}/iterations` returns persisted iteration data with per-check results, enabling History tab drill-downs and custom reporting.
 - **Persistent run history** — the dashboard stores run history, iterations, and check results in a SQLite database at `~/.ralph/ui.db` that survives across restarts.
+- **Keyboard shortcuts in dashboard** — press Cmd+S / Ctrl+S to save changes in primitive editors and create forms. Escape closes the New Run modal.
+- **History runs API endpoint** — `GET /api/history/runs` returns all persisted runs from the SQLite store, enabling custom history queries and reporting.
 
 ### Fixed
 

docs/dashboard.md

@@ -255,6 +255,18 @@ open it and the overlay to close it. Controls and spacing tighten further below
   <figcaption>On phones, the sidebar collapses and the layout stacks vertically.</figcaption>
 </figure>
 
+## Keyboard shortcuts
+
+The dashboard supports keyboard shortcuts for common actions:
+
+| Shortcut | Where | Action |
+|---|---|---|
+| <kbd>Cmd+S</kbd> / <kbd>Ctrl+S</kbd> | Primitive editor | Save changes to the current primitive |
+| <kbd>Cmd+S</kbd> / <kbd>Ctrl+S</kbd> | Create primitive form | Create the new primitive |
+| <kbd>Escape</kbd> | New Run modal | Close the modal |
+
+The save shortcut works in both the edit and create views of the Configure tab — press <kbd>Cmd+S</kbd> (Mac) or <kbd>Ctrl+S</kbd> (Windows/Linux) instead of clicking the Save or Create button.
+
 ## REST API
 
 The dashboard exposes a REST API you can use to script runs, manage primitives,
@@ -424,6 +436,49 @@ Each iteration includes:
 | `duration`   | string\|null      | Formatted duration (e.g. `"52.3s"`)                      |
 | `checks`     | array\|null       | Per-check results, or `null` if no checks ran            |
 
+#### List past runs (history)
+
+Retrieve all persisted runs from the SQLite store — these survive dashboard
+restarts. This is what powers the History tab.
+
+```bash
+curl http://127.0.0.1:8765/api/history/runs
+```
+
+```json
+[
+  {
+    "run_id": "a1b2c3d4",
+    "status": "completed",
+    "command": "claude",
+    "prompt_file": "PROMPT.md",
+    "started_at": "2026-03-11T14:23:01",
+    "stopped_at": "2026-03-11T14:35:12",
+    "iterations": 5,
+    "completed": 4,
+    "failed": 1,
+    "timed_out": 0
+  }
+]
+```
+
+Each run includes:
+
+| Field        | Type         | Description                                    |
+|--------------|--------------|------------------------------------------------|
+| `run_id`     | string       | Unique run identifier                          |
+| `status`     | string       | `"running"`, `"completed"`, `"stopped"`, etc.  |
+| `command`    | string       | Agent command used                             |
+| `prompt_file`| string       | Path to the prompt file                        |
+| `started_at` | string\|null | ISO 8601 start timestamp                       |
+| `stopped_at` | string\|null | ISO 8601 stop timestamp                        |
+| `iterations` | int          | Total iterations executed                      |
+| `completed`  | int          | Iterations that succeeded                      |
+| `failed`     | int          | Iterations that failed                         |
+| `timed_out`  | int          | Iterations that timed out                      |
+
+Runs are returned newest-first. Combine with the [iterations endpoint](#get-iterations-for-a-run) to drill into a specific run's details.
+
 ### Primitives
 
 Primitive endpoints use a base64-encoded `project_dir` in the URL path. Encode

docs/quick-reference.md

@@ -227,6 +227,18 @@ Frontmatter `command` values are split with `shlex` and run **directly** (no she
 
 ---
 
+## Dashboard keyboard shortcuts
+
+| Shortcut | Where | Action |
+|---|---|---|
+| <kbd>Cmd+S</kbd> / <kbd>Ctrl+S</kbd> | Primitive editor | Save changes |
+| <kbd>Cmd+S</kbd> / <kbd>Ctrl+S</kbd> | Create primitive form | Create the primitive |
+| <kbd>Escape</kbd> | New Run modal | Close the modal |
+
+See [Web Dashboard](dashboard.md#keyboard-shortcuts) for details.
+
+---
+
 ## Prompt assembly order
 
 Each iteration assembles the prompt in this order: