diff --git a/vim/README b/vim/README
new file mode 100644
index 00000000..bd453a40
--- /dev/null
+++ b/vim/README
@@ -0,0 +1,10 @@
+This directory contains a vim script that allows reading notmuch mail
+through vim.
+
+To install:
+
+        make install
+
+To run:
+
+        vim -c ':NotMuch'