diff --git a/docs/codex.md b/docs/codex.md
index 50d1b693..a7457f30 100644
--- a/docs/codex.md
+++ b/docs/codex.md
@@ -49,6 +49,8 @@ Follow the device code flow in your browser, then restart the pod:
 kubectl rollout restart deployment/openab-codex
 ```
 
+> **Note**: See [gh-auth-device-flow.md](gh-auth-device-flow.md) for `gh` device flow in headless containers and pods.
+
 ### Persisted Paths (PVC)
 
 | Path | Contents |