diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5ea555f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# stdouterr
+
+## combining stdout and stderr
+
+### what is `stdouterr`?
+
+a cli application that writes to stdout and stderr upon execution
+
+### why is `stdouterr`?
+
+often while testing shell redirections, i am not sure if i am doing it right. 🤦😠
+so i made a shell script each time. this is an attempt to not repeat myself, and have
+have a readily available tool i can use 🤓✨
+
+### how is `stdouerr`?
+
+🥚 initialised
+
+
+### contributing
+
+not licensed yet. but there isn't really a lot of "unique" code to license 🤷