update utils
include api examples and api docs if available
always source env, do not bail if not found
subst on repo dir name
fix typo