diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..4f9312e
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,5 @@
+# Changelog
+
+Last updated: 2026-07-01T08:40:58.954Z
+
+- docs: document all environment variables with default values