diff --git a/README.md b/README.md
new file mode 100644
index 0000000..11c7aa9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+Notifies of available updates.
+
+`pacman-update-count.sh` -- run as root to update available count.
+
+`notify-updates` -- run to notify of available updates (gets value stored by `pacman=update-count.sh`).
+
+```sh
+# list options:
+
+notify-updates --help
+```