Thanks @mdma for the details on this, a great start that will undoubtably help–I totally know what you mean about writing a good how-to, it takes way longer than expected, 
@steveg_uk , yes, the CLI is currently being developed, I’ll also looking forward to wiring it up to run in a MacVim environment. Will certainly post here when we release this.