How do you install and use it – what about a readme – the instructions take me to a page that looks like I need to be a mindreader to install the plugin !!

Is it really that difficult to provide some basic instructions!

Available Shortcode UI attribute fields include: text, checkbox, textarea, radio, select, email, url, number, date, attachment, color, post_select, term_select.

Take a look at the dev plugin for a detailed example on how you’d register UI.