diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6ec07d7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# Advent of Code 2018
+
+My solutions. We can run a solution like so:
+```
+cargo run x y
+```
+where `x` is the day and `y` is the part.
+
+We can also run the examples with:
+```
+cargo test
+```