diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..7ef8afb
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,21 @@
+# hadron
+
+Simple rust utility to configure meson build directories in a TUI
+
+## Building
+```bash
+git clone https://github.com/tboudreaux/hadron
+cd hadron
+cargo build --release 
+```
+
+## Usage
+```bash
+hadron buildDir
+```
+
+You will be presented with a list of options for that meson project.
+
+- There are vim like motions to move around
+- space will toggle possible options or open an edit window for free form options
+- / will search