shell fixes, update readme