cli tool + readme updates + bug fixes