diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..73fc973
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,9 @@
+ud
+==
+
+get definitions from urbandictionary from the comfort of your command prompt.
+
+installation
+------------
+
+        go get mcquay.me/ud