diff --git a/README.md b/README.md
new file mode 100644
index 0000000..73c47ff
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# dotfiles
+
+My config files and things. May contain cruft.
+
+## Installation
+
+Using [homesick](https://rubygems.org/gems/homesick):
+
+    gem install homesick
+    homesick clone git@github.com:walkah/dotfiles.git
+    homesick symlink dotfiles
+
+## Updates
+
+    homesick pull dotfiles && homesick symlink dotfiles