diff --git a/AGENTS.md b/AGENTS.md
index b69ace15eff47459362ff524937e34cd8786391f..99ce8d2ea8f6aa2b8c27b1ee2ca305f2b297e380 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -15,6 +15,13 @@ Guidance for AI coding agents working in this repository. Document only reflects
 - Module path: `git.secluded.site/np`
 - Binary name: `np`
 
+**Note:** a stable, usable version of `np` is already in your PATH. If
+you're Codex, you need to escalate and ask user permission to run `np`
+commands. If you're another coding agent like Crush or Amp or Claude
+Code or Cursor, just execute `np` as a normal shell command. To use the
+development build against the user's stable database (BE CAREFUL ABOUT
+MIGRATIONS!) run `task build`, then execute `./np`.
+
 ## Development Commands (Taskfile)
 
 - Format: `task fmt` (installs and runs gofumpt)