diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8f29092
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# MSH
+- a toy shell implementation
+
+## What it can do
+- handle text input
+- run binaries
+- change directory
+
+## What it can't do
+- any sort of scripting, variables
+- no fatal memory corruption bugs
+- pretty colors and themes :(