Work with agents
Review and ship
Review what the agent changed file by file, follow checks, open and merge pull requests, and wrap up a finished task.
Review, check and ship a task's work from the Preview pane beside the chat. Its tabs are listed in Code workspace.
Plans and pointers
- When an agent plans first, the plan opens in Task details as a tab beside Description. You can edit it in place; it saves on its own. A plan from plan mode shows as Plan (plan mode) and is read-only.
- An agent can bring Changes, Checks, Terminal or the plan to the front, open a file at a line, or open its dev server in Preview. It only points; your files don't change.
Review changes
Changes lists every file the agent changed since the task started, with line counts. Click a file to see its diff. With several repositories, files are grouped under each one. Binary files and files over 2 MB are listed but not diffed.
Close the chat with the arrow on the divider for the review view: files by folder on the left, the diff on the right with Edit, Explain and Mark reviewed. Type in Filter changed files…, or use the chips tests, generated, binary and reviewed to hide those files. If the agent edits a file after you ticked it, the tick drops off.
| Key | Action |
|---|---|
↑ ↓ or ⇧N ⇧P | Next or previous file |
n p | Next or previous change |
v | Mark reviewed, go to the next unreviewed file |
e | Edit the file at this change in All files |
x | Revert this change |
a | Ask the agent about this change |
Esc | Back to the file list |
- Revert (
x) puts one change back the way it was, after you confirm. It works on edited files only; for added, deleted or renamed files, ask the agent. Stop the agent first if it is working. - Explain gets a plain-words explanation of the selected lines or the whole file. Ask (
a) sends your question about a change. Answers arrive in the chat.
Checks
Checks lists every status check on the task's pull requests, grouped by PR, with a count such as 4 of 5 passed. Until there is a pull request, the tab says so.
- Click a GitHub Actions check to see its steps, the end of its log and Open on GitHub. Checks from other services open in your browser.
- A failed check puts a red dot on the Checks icon and names the failure in the PR bar.
- Before a commit, push, pull request or merge lands, your guardrails check it. A card such as Checks before this commit says why a change was stopped.
Pull requests
Pull requests need the GitHub CLI: run brew install gh, then gh auth login.
To open one, ask in the chat, or click Open PR once every file is reviewed, or in the PR menu beside a repository with none. The agent commits what is left, pushes and opens the PR against the default branch. PRs opened from Zokie end with a "Built with 🧊Zokie" line.
The PR bar above the tabs shows the PR's number (opens GitHub) and its state (opens Checks):
| State | Next step |
|---|---|
| Draft · not ready to merge | Mark it ready on GitHub |
| Checks running · 2 of 5 | Wait; Merge unlocks when they pass |
| 1 check failed · build or Has conflicts | Ask Dev to fix |
| Ready to merge | Merge |
| Merged or Closed without merging | Open PR opens it on GitHub |
Ask Dev to fix has the agent fix the failure or conflict and push; follow it in the chat. It and Open PR are off while the agent works.
To merge, click Merge, check the dialog (PR, target branch, check counts), then Merge PR #n. Zokie squash-merges. It never merges on its own, and drafts can't be merged. You can also merge from your phone.
With several repositories or PRs, the bar shows one menu, such as 3 PRs, listing each PR with its state and Merge.
Wrap up
When every pull request is merged, a bar reads All pull requests are merged. Click Done to tick the task off; it moves to the bottom of its Plan section. Subtasks don't show this bar; their main task does. PRs closed without merging leave the task open.
- Finish any task: right-click it in the task list › Mark as Done.
- Clear completed in the Plan header archives every done task. Its arrow sets auto-archive: End of day (default), End of week or Never. Settings › Tasks › Archive Done tasks also takes 1 to 90 days.
- An archived task keeps its chat. Open it and click Restore to keep working. Your branches stay. See Tasks.