diff --git a/shell/README.md b/shell/README.md
new file mode 100644
index 00000000..c1dee248
--- /dev/null
+++ b/shell/README.md
@@ -0,0 +1,8 @@
+### A prototype shell for the Mu computer
+
+Currently runs a tiny subset of Lisp. To build and run it from the top-level:
+
+```
+./translate shell/*.mu
+qemu-system-i386 disk.img
+```