Review, promote or abandon an agent's work

tovio agent list

Shows issued tokens, their scope, their expiry, and whether each is active, expired or revoked.

Review

tovio log --entity agenttovio change show <chg-id> --difftovio semantic difftovio build-check

Run semantic diff on agent work as a habit. A model that has confidently changed a public signature produces a small textual diff and a large breaking change, and only one of those two is visible in a normal review.

Promote

tovio agent promote <name> --onto main

Promote is not a shortcut past your gates. It runs the same checks tovio land does — the pre-land plugin gate, protected-lane conflict refusal, file locks, and the semantic check — so a conflicted or blocked agent lane is refused rather than force-landed. Only after the land succeeds is the agent lane torn down, and the review is recorded in a signed audit entry.

Change ids survive, so a review attached to a change stays attached. You cannot promote the lane you are standing on; switch off it first.

Abandon

tovio agent abandon agent/<name>

Tombstones the lane. Its objects stay reachable in history — nothing is orphaned — and it is recorded as an ordinary lane deletion, so tovio undo puts it back if you were too quick.

Partial acceptance

tovio change split <chg-id> --paths 'src/api/**'

Carve the good part into its own change and leave the rest. --paths is repeatable and at least one is required. Usually better than asking for a redo.

When you are done

tovio agent revoke <token-id>

Revoke the token when the task is finished rather than letting it lapse.