diff --git a/README.md b/README.md
index e69de29..483cb28 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,36 @@
+# Script collection
+
+This is a collection of scripts I use on different systems
+
+## Unix
+
+#### run
+
+Simple script to run programs detached from terminal.
+No nohup.out, no stdout or stderr, don't close program when terminating the terminal.
+
+
+#### rgit
+
+Utility to remotely work on git repos through ssh.
+Create, list or delete bare repos on git server. Edit your config and description locally in your $EDITOR.
+
+***TODO***
+- Create, list, delete, edit hooks
+
+
+
+## MacOS
+
+#### mcal
+
+Show a calendar in your terminal the way gcal **should**.
+From [this](https://apple.stackexchange.com/questions/93906/cal-command-start-monday) stackexchange post.
+
+This does not work perfectly but **WHOSE** idea was it to display a calendar vertically?!
+
+
+#### displayer
+
+Reorganize your displays with displayplacer. Documentation on how to properly set this up is [here](https://github.com/jakehilborn/displayplacer).
+And again, I just have to ask: **WTF APPLE ?!** How hard is it to not fuck my displays up after every boot?