diff --git a/README.md b/README.md
new file mode 100644
index 0000000..668a939
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# niri
+
+The beginnings of a Wayland compositor.
+
+## Running
+
+`cargo run -- -- alacritty`
+
+Inside a desktop session, it will run in a window. On a TTY, it will run natively.
+
+To exit when running on a TTY, press Super+Shift+e.
+