diff --git a/gitnexus/.env.example b/gitnexus/.env.example
index 0c4cd297d..26a203505 100644
--- a/gitnexus/.env.example
+++ b/gitnexus/.env.example
@@ -10,3 +10,11 @@
 
 # Works with Infinity, vLLM, TEI, llama.cpp, Ollama, LM Studio, or OpenAI.
 # See README for details.
+
+# OpenTelemetry metrics with Prometheus exporter on `gitnexus serve`.
+# Opt-in; defaults off. Loopback bind by default — reverse-proxy if you
+# need wider exposure. See src/mcp/metrics.ts.
+# GITNEXUS_OTEL_METRICS=on
+# GITNEXUS_OTEL_METRICS_PORT=9464
+# GITNEXUS_OTEL_METRICS_HOST=127.0.0.1
+# GITNEXUS_OTEL_METRICS_ENDPOINT=/metrics