cleanup examples, provide documentation

Oh, and a bug-fix: the agents-stop command was not working