diff --git a/scripts/nym/README.md b/scripts/nym/README.md
new file mode 100644
index 0000000..ad6939a
--- /dev/null
+++ b/scripts/nym/README.md
@@ -0,0 +1,9 @@
+# scripts/nym — helpers for `koopa-nym`
+
+| Script | Role |
+|--------|------|
+| `build.sh` | `podman build` image `localhost/koopa-nym:latest` |
+| `up.sh` | compose up in `~/koopa-nym` or `configs/nym` |
+| `status.sh` | container + HTTP API probe |
+
+Config mirror: `configs/nym/`. Live host tree: `~/koopa-nym/`.