client and tools + readme updates