1 files changed, 13 insertions, 0 deletions
diff --git a/lib/shell/README.md b/lib/shell/README.md
new file mode 100644
index 00000000..4adb8cff
--- /dev/null
+++ b/lib/shell/README.md
@@ -0,0 +1,13 @@
+# Shell
+
+This module defines a `lang` for running shell scripts:
+
+```tomo
+use shell
+
+>> $Shell"
+    seq 5
+    echo DONE
+":get_output()
+= "1$\n2$\n3$\n4$\n5$\nDONE"
+```