From 2e58ffd65319b161bda1e43f2de37b22c698125c Mon Sep 17 00:00:00 2001
From: "Kartik K. Agaram" <vc@akkartik.com>
Date: Mon, 8 Mar 2021 21:03:15 -0800
Subject: [PATCH] .

---
 shell/README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/shell/README.md b/shell/README.md
index c1dee248..fabf16fa 100644
--- a/shell/README.md
+++ b/shell/README.md
@@ -6,3 +6,16 @@ Currently runs a tiny subset of Lisp. To build and run it from the top-level:
 ./translate shell/*.mu
 qemu-system-i386 disk.img
 ```
+
+You can type in expressions, hit `ctrl-s` to see their results, and hit `Tab`
+to focus on the `...` below and browse how the results were computed. [Here's
+a demo.](https://merveilles.town/@akkartik/105790894303047592) The bottom of
+the screen shows context-dependent keyboard shortcuts (there's no mouse in the
+Mu computer at the moment).
+
+*Known issues*
+
+* There's no way to save to disk.
+
+* Don't press keys too quickly (such as by holding down a key). The Mu
+  computer will crash (and often Qemu will segfault).