diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..bbb9190
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,5 @@
+# Changelog
+
+Last updated: 2026-07-14T22:28:05.830Z
+
+- docs: add troubleshooting section for common setup errors