diff --git a/docs/how-to/install-heph.md b/docs/how-to/install-heph.md
index fa69e02..dd0036a 100644
--- a/docs/how-to/install-heph.md
+++ b/docs/how-to/install-heph.md
@@ -1,6 +1,6 @@
 ---
 title: Install heph (and isolate dev)
-modified: 2026-06-02
+modified: 2026-06-04
 tags:
   - how-to
 ---
@@ -14,18 +14,19 @@ linux/arm64, linux/amd64).
 
 ## 1. Install the binaries from the forge
 
-Build and install `heph` + `hephd` to `~/.cargo/bin` (on `PATH`) from a forge
-ref. Until v1 is tagged, install from the branch:
+Build and install `heph` + `hephd` to `~/.cargo/bin` (on `PATH`) from the latest
+release tag:
 
 ```bash
 cargo install --locked \
   --git ssh://forgejo@forge.ops.eblu.me:2222/eblume/hephaestus.git \
-  --branch feature/v1-prototype \
+  --tag v1.0.0 \
   heph hephd
 ```
 
-Re-run with `--tag vX.Y.Z` once a release is cut. This needs forge SSH access
-(an unlocked 1Password / ssh-agent key).
+Bump `--tag` to upgrade to a newer release; to track unreleased work instead,
+swap `--tag vX.Y.Z` for `--branch main`. This needs forge SSH access (an
+unlocked 1Password / ssh-agent key).
 
 `heph --version` / `hephd --version` report `X.Y.Z (<git-sha>)` for a tagged
 install and `0.0.0 (<git-sha>)` for a branch/dev install — the release version