diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6afefa6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+# CocoRice
+
+Install my dotfiles.
+
+## Table of contents
+- [Installation <a name="installation"></a>](#installation-)
+- [Usage <a name="usage"></a>](#usage-)
+- [Contributing <a name="contributing"></a>](#contributing-)
+- [License <a name="license"></a>](#license-)
+
+## Installation <a name="installation"></a>
+
+Clone the repo.
+
+## Usage <a name="usage"></a>
+
+Run
+
+```bash
+./scripts/linkFiles.sh
+```
+
+and it will create symbolic links to the dotfiles in this repo.
+
+Note that that this script will overwrite your local dotfiles, so make a backup first.
+
+## Contributing <a name="contributing"></a>
+PRs are welcome.
+
+## License <a name="license"></a>
+[MIT](https://choosealicense.com/licenses/mit/)