Initial work on feature-branch checkout.
todo missing README.md file.  + code clean up + review.
small code clean up and error handling.
updatede README.md