diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..e66d71e
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,5 @@
+# Changelog
+
+Last updated: 2026-06-16T01:28:45.476Z
+
+- docs: add troubleshooting section for common setup errors