diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9f23df8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+dotfiles
+===
+
+Just a collection of my dotfiles. Having them up here is nice for setting up new machines, and maybe others will find them useful.
+
+Installation
+---
+
+- git clone this repo
+
+- run ./install.sh
+
+Credits
+---
+
+All the people who made all the cool tools and configurations that I am using
+
+Particular thanks to:
+
+- [vim pathogen](https://github.com/tpope/vim-pathogen)
+
+- [Bash magic](https://github.com/Knewton/bash_magic)
+
diff --git a/install.sh b/install.sh
new file mode 100644
index 0000000..5502059
--- /dev/null
+++ b/install.sh
@@ -0,0 +1,3 @@
+#!/bin/bash
+
+echo "not finished, check back later"