diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..41b67d0
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,27 @@
+# Changelog
+
+## 1.0.0 (2025-07-25)
+
+### Features
+
+- Check Code Tool
+  - reads supplied code files to see if form fields are present and represented
+    in a switch statement
+- Field Rename Tool
+  - provide a search and replace pattern to bulk rename form fields
+- List Form Fields
+  - Sometimes you just need to see what fields there are
+
+### Known Issues
+
+- Field rename does not represent full change applied to the field, only the
+  replaced text
+- help flags can cause issues
+- ascii art is broken (sad face)
+- banana doesn't work
+
+## 0.0.0 (never)
+
+this is just here for a reference to the auto-changelog
+
+<!-- auto-changelog -->