improved README
casts for opts