diff --git a/docs/tools/forge-cli.md b/docs/tools/forge-cli.md
index 7e544401..13b21a3f 100644
--- a/docs/tools/forge-cli.md
+++ b/docs/tools/forge-cli.md
@@ -1370,7 +1370,7 @@ Re-run CI without an empty commit. Pass one of `--pr <n>`, `--run <n>`, or `--br
 
 ###### **Options:**
 
-* `--pr <PR>` — Re-run CI for this PR (its head branch). Mutually exclusive with `--run` / `--branch`
+* `--pr <PR>` — Doesn't work: a `workflow_dispatch` run writes no commit status, so it can't clear a red `(pull_request)` check — re-run from the web UI instead. Mutually exclusive with `--run` / `--branch`
 * `--run <RUN>` — Re-run the same workflow on the same branch this run used. The run number is the `runs/<n>` in the run-page URL. Mutually exclusive with `--pr` / `--branch`
 * `--branch <BRANCH>` — Re-run `--workflow` on this branch. Mutually exclusive with `--pr` / `--run`
 * `--workflow <WORKFLOW>` — Workflow file to run (default `ci.yml`). Ignored for `--run`, which uses the run's own workflow
diff --git a/hive-forge/src/verbs/ci_rerun.rs b/hive-forge/src/verbs/ci_rerun.rs
index 7964bb05..8f666276 100644
--- a/hive-forge/src/verbs/ci_rerun.rs
+++ b/hive-forge/src/verbs/ci_rerun.rs
@@ -34,8 +34,9 @@ use crate::client::{Client, index};
 
 #[derive(ClapArgs)]
 pub struct Args {
-    /// Re-run CI for this PR (its head branch). Mutually exclusive with
-    /// `--run` / `--branch`.
+    /// Doesn't work: a `workflow_dispatch` run writes no commit status, so
+    /// it can't clear a red `(pull_request)` check — re-run from the web UI
+    /// instead. Mutually exclusive with `--run` / `--branch`.
     #[arg(long, conflicts_with_all = ["run", "branch"])]
     pr: Option<u64>,
     /// Re-run the same workflow on the same branch this run used. The run