diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a4b4842
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# irccrab 🦀
+
+rust alternative to [ircdog](https://github.com/ergochat/ircdog)
+because i did not feel like installing go
+
+- automatically responds to irc `PING`s
+- connects via tls (rustls) or plaintext
+- can use an alternative cafile or disable tls verification entirely
+- supports client certificate authentication
+