diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..c8d29fd
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,5 @@
+README.md: header.md cli-apps.md
+	cat header.md cli-apps.md > README.md
+
+cli-apps.md: cli2md.py cli-apps.yaml
+	python3 cli2md.py > cli-apps.md
diff --git a/header.md b/header.md
new file mode 100644
index 0000000..17017d5
--- /dev/null
+++ b/header.md
@@ -0,0 +1,14 @@
+# Forewords
+
+This repository contains a list of CLI apps with links and a short description.
+
+This ``README`` file is automatically generated from ``cli-apps.yaml`` using ``cli2md.py`` (it requires the ``yaml`` package to run).
+It is commited into the repo for easier access to the content.
+
+Type
+
+```
+make
+```
+
+to build the latest version of ``README.md``.