readme and console improvements