fix top-level bin
add readme with thoughts