diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e01e5db
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+Simple cli tool for serving files in a directory. A silly excuse for me to
+write something tiny in go.
+
+Installation:
+
+    go get bitbucket.org/smcquay/servedir
+
+use:
+
+    servedir  # default port
+
+    # specify port
+    servedir -port 6666
+
+    # allow serving hidden files/dirs
+    servedir -hidden
+
+    # or see -help