Skip to content

Start

Run the first task

Start with one useful task, not a demo. Run a real task with excellent run, read the attempt it records, and know what the exit codes mean.


Run a task that has a real expected outcome in your repository.

excellent run --agent <role> --task <task-id>

Both flags are required. --task must be an existing numeric task id: a free-text objective is validated and then refused with a structured hint, because the underlying pathway targets task ids. File the objective as a task first.

Expected result: the role attempts the work, Excellent records the attempt, and a correlationId is printed on stderr. Exit 0 completed, 1 not completed, 2 usage.

If Excellent cannot tell whether the work passed, the result is Not checked or Needs a decision, not a silent pass.

Undo the accepted change with the rollback instruction attached to the result.