docs: document that ralph run accepts a direct RALPH.md file path

The code in _resolve_ralph_paths() already supports passing either a
directory or a direct path to a RALPH.md file, but the CLI help text
and docs only mentioned directories. Updated the CLI reference, quick
reference, and Typer help text to reflect both options.

Co-authored-by: Ralphify <noreply@ralphify.co>

Author: 2 people

docs/cli.md

@@ -49,7 +49,7 @@ ralph run my-ralph --dir ./src             # Pass user args to the ralph
 
 | Argument / Option | Short | Default | Description |
 |---|---|---|---|
-| `PATH` | | (required) | Path to a ralph directory containing `RALPH.md` |
+| `PATH` | | (required) | Path to a ralph directory containing `RALPH.md`, or a direct path to a `RALPH.md` file |
 | `-n` | | unlimited | Max number of iterations |
 | `--stop-on-error` | `-s` | off | Stop loop if agent exits non-zero or times out |
 | `--delay` | `-d` | `0` | Seconds to wait between iterations |

docs/quick-reference.md

@@ -12,6 +12,7 @@ Everything you need at a glance. Bookmark this page.
 
 ```bash
 ralph run my-ralph                 # Run loop forever (Ctrl+C to stop)
+ralph run my-ralph/RALPH.md        # Can also pass the file path directly
 ralph run my-ralph -n 5            # Run 5 iterations
 ralph run my-ralph -n 1 --log-dir logs  # Single iteration with output capture
 ralph run my-ralph --stop-on-error # Stop if agent exits non-zero or times out

src/ralphify/cli.py

@@ -436,7 +436,7 @@ def _build_run_config(
 @app.command(context_settings={"allow_extra_args": True, "allow_interspersed_args": True, "ignore_unknown_options": True})
 def run(
     ctx: typer.Context,
-    path: str = typer.Argument(..., help="Path to the ralph directory (containing RALPH.md)."),
+    path: str = typer.Argument(..., help="Path to a ralph directory or RALPH.md file."),
     n: int | None = typer.Option(None, "-n", help="Max number of iterations. Infinite if not set."),
     stop_on_error: bool = typer.Option(False, "--stop-on-error", "-s", help="Stop if the agent exits non-zero or times out."),
     delay: float = typer.Option(0, "--delay", "-d", help="Seconds to wait between iterations."),