fix and refactor failing commands
add docs to add an widget