diff --git a/port-to-omp.mjs b/port-to-omp.mjs
index 3e0e8cf..66206ad 100644
--- a/port-to-omp.mjs
+++ b/port-to-omp.mjs
@@ -7,12 +7,12 @@
  * --out) is a generated artifact. Every op asserts its target and fails
  * loudly on base drift — never silently producing a stale port.
  *
- * Usage:
- *   bun port-to-omp.mjs                # write ~/.omp/agent/extensions/pygenium
- *   bun port-to-omp.mjs --out <dir>    # write elsewhere (CI: the omp repo clone)
+ * The port is updated ONLY by CI on push (see below) — never by hand; local
+ * edits to ~/.omp/agent/extensions/pygienium are overwritten by the next run.
  *
  * CI: .gitea/workflows/port-to-omp.yml clones the omp-pygienium repo and
- * runs this script into it, then commits + pushes when the port changed.
+ * runs this script into it (`bun port-to-omp.mjs --out <dir>`), then
+ * commits + pushes when the port changed.
  */
 
 import {