diff --git a/.gitignore b/.gitignore
index d3ce4df0..2781cb69 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,6 +3,7 @@ build-harness/
aws-assumed-role/
.idea/
*.iml
+.atmos
# Compiled or generated files
# Compiled and auto-generated files
diff --git a/Makefile b/Makefile
index 7f6716d0..3801c94e 100644
--- a/Makefile
+++ b/Makefile
@@ -77,3 +77,8 @@ bash/fmt/check:
shfmt -d $(PWD)/rootfs
.PHONY: all %.all build %.build install %.install run %.run run/new run/check
+
+readme/build:
+ @atmos docs generate readme
+
+readme: readme/build
diff --git a/README.md b/README.md
index 5288e92e..69205d60 100644
--- a/README.md
+++ b/README.md
@@ -2,8 +2,11 @@

-