diff --git a/docs/tools/forge-cli.md b/docs/tools/forge-cli.md
index 857817ef..5747f86a 100644
--- a/docs/tools/forge-cli.md
+++ b/docs/tools/forge-cli.md
@@ -548,12 +548,16 @@ Create a pull request
 
 PR health view: mergeable / CI / reviews
 
-**Usage:** `hive-forge pr status [OPTIONS]`
+**Usage:** `hive-forge pr status [OPTIONS] [NUMBER]`
+
+###### **Arguments:**
+
+* `<NUMBER>` — PR number — full health view (mergeable, CI, reviews, last comment). Mutually exclusive with `--sha`
 
 ###### **Options:**
 
-* `--pr <PR>` — PR number — full health view (mergeable, CI, reviews, last comment). Mutually exclusive with `--sha`
-* `--sha <SHA>` — Explicit commit sha (or ref) — CI-only fast path. Mutually exclusive with `--pr`
+* `--pr <PR>` — Same as passing the number positionally. Kept because this verb accepted only this spelling before the positional existed
+* `--sha <SHA>` — Explicit commit sha (or ref) — CI-only fast path. Mutually exclusive with a PR number