diff --git a/plugins/getgb/README.md b/plugins/getgb/README.md
new file mode 100644
index 00000000..b477b0f4
--- /dev/null
+++ b/plugins/getgb/README.md
@@ -0,0 +1,10 @@
+# *gb* plugin
+
+- aims to support completion for all *gb* commands
+- also supports completion for *gb* plugins such as *vendor*
+
+See http://getgb.io for the full *gb* documentation
+
+## Caveats
+
+- The *git* plugin installs an alias *gb* that usually conflicts with the *gb* program