diff --git a/README.md b/README.md
new file mode 100644
index 0000000..54fa7bb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# squeak
+
+A nut obsessed saber-toothed client for pnut.io
+
+[source code](https://git.sr.ht/~thrrgilag/squeak) - 
+[issue tracker](https://todo.sr.ht/~thrrgilag/squeak) - 
+[releases](https://git.sr.ht/~thrrgilag/squeak/refs) - 
+[mailing list](https://lists.sr.ht/~thrrgilag/squeak) - 
+[chat room](https://thrrgilag.dev/chat/dev)
+
+## Contributing
+
+Send patches to 
+[~thrrgilag/squeak@lists.sr.ht](https://lists.sr.ht/~thrrgilag/squeak).  
+
+A nice tutorial on how to do that can be found at 
+[git-send-email.io](https://git-send-email.io/).
+
+If you have difficulty and would like assistance don't be afraid to ask.
+
+Send bugs to 
+[~thrrgilag/squeak@todo.sr.ht](https://todo.sr.ht/~thrrgilag/squeak).
+