diff --git a/README.md b/README.md
new file mode 100644
index 0000000..99353db
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# uiua shell
+
+uiua is a fun language, this is an attempt at living and breathing uiua by implementing a terminal shell in uiua.
+
+```
+~/uash λ ls
+flake.lock  flake.nix  README.md  uash.ua
+~/uash λ echo hello world
+hello world
+~/uash λ exit
+```
+
+## roadmap
+
+- [x] colorterm ps1 support
+- [x] `cd`
+- [x] `exit`
+- [ ] uiua code
+- [ ] control signals
+- [ ] pipes