diff --git a/README b/README
new file mode 100644
index 0000000..96418f1
--- /dev/null
+++ b/README
@@ -0,0 +1,14 @@
+autotypist
+
+This can be used to maintain git repositories
+
+* Scans directories looking for git repositories
+* The default behavior is to use 3 branches. 'master or main', 'devel', '<username>'
+* shows tags and dirty state
+* uses a GUI or the console(console display needs work)
+* always wrap around 'git' -- it basically just types 'git' commands really fast
+
+Notes & Goals:
+
+* use a GUI that also works on the command line
+* andlabs GTK gui plugin starts breaking around 200 repos