1 files changed, 10 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a1547eb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+## macOS configuration script
+
+The script resides in *.macos*, is invoked by the setup script, and is
+designed to run idempotently. Starting with macOS 10.14 Mojave, granting
+*Full Disk Access* to your terminal application is required to configure
+applications such as Mail, Messages, and Safari.
+
+```bash
+bash .macos
+```