diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a12678d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# Dev instructions
+
+```
+# Run a test nested X server with dimensions tuned for i3 status bar work
+$ Xephyr :1 -screen 1280x200 &
+# Run i3 with a custome socket directory so you don't clash with any
+# preexisting ones.
+# TODO(wathiede): write stripped down i3 config and use it
+$ I3SOCK=/tmp/i3 DISPLAY=:1 i3
+```