diff --git a/README.md b/README.md
new file mode 100644
index 0000000..10a00d8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# Joe CLI tool
+
+### THIS TOOL IS UNDER HEAVY DEVELOPMENT ###
+
+**What for?**
+Joe makes assming AWS roles pretty simple, asking for AWS temporal credentials and dumping them to ~/.aws/credentials
+
+**How to use it**
+You can use explicit arn roles or use a __role alias__ configured in ~/.joe/roles