diff --git a/README.md b/README.md
new file mode 100644
index 0000000..293a7a9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+🏘️ scripts to configure webserver vhosts (apache2, nginx) locally (with SSL/certbot support)
+
+```
+usage: vhost.py [-h] [-a | -r] domain [domain ...]
+
+positional arguments:
+  domain        vhost domain(s)
+
+options:
+  -h, --help    show this help message and exit
+  -a, --add     adds vhost for given domain(s)
+  -r, --remove  removes vhost for given domain(s)
+```
+
+```
+usage: cert.py [-h] [-a | -r] domain [domain ...]
+
+positional arguments:
+  domain        vhost domain(s)
+
+options:
+  -h, --help    show this help message and exit
+  -a, --add     adds cert for given domain(s)
+  -r, --remove  removes cert for given domain(s)
+```
\ No newline at end of file