diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8d49149
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+# mg
+
+Golang replacement for [myrepos](https://myrepos.branchable.com/) which only supports git repos.
+
+This app will support the following subcommands:
+
+- mg commit
+- mg push
+- mg status
+- mg diff
+- mg pull
+- mg fetch
+- mg register
+
+Passing the `-jX` argument will spin up X jobs simultaneously
+
+mg supports loading an existing ~/.mrconfig and migrating it to ~/.config/mg.conf, provided no mg.conf file exists.
+
+
+## Improvements over mr:
+1. No external dependencies (except for git) 
+1. More output options (summary of failures)
+1. More deterministic behavior (global vs local run)
+
+
+## Why to stick with mr:
+1. If you need support for non-git repos
+1. If you want to use the [mr plugin ecosystem](https://myrepos.branchable.com/#:~:text=repos%20to%20myrepos-,related%20software,-garden%3A%20manage%20git)