diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..e70a9c1
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,5 @@
+# Changelog
+
+Last updated: 2026-07-02T11:38:37.331Z
+
+- docs: document all environment variables with default values