Whiteboards
Review Agent changes to a board
The Agent edits an open board directly, through the same commands you use. Review its changes on the canvas, use the board check, and roll back through Version history when needed.
Updated
By Kition Docs
Verified against Kition 0.2.0 (7d49036f) on 2026-11-06
Ask for a bounded change
Describe the intended result and the parts of the board that must remain intact. “Arrange these notes into three research themes without deleting the quotations” is easier to verify than “Improve this board”. The open board gives the Agent context, but you still need to define a successful outcome.
Review is an editorial decision, not just a confirmation that the tool ran. A change can be technically valid while removing an important distinction or drawing an unsupported relationship between ideas. The Board kit does not offer agent drafts, so on a board the Agent’s edits land in the open file as it works, and Kition records a version after an agent edit.
Check the result and roll back if needed
- Open the board and describe the change in the Agent panel.
- Watch the canvas while the Agent works; the conversation lists the files it modified, with a link to view the changes in each one.
- Inspect the added, moved, and deleted elements on the canvas, especially connectors, labels, and frames.
- If something is wrong, ask the Agent to undo its last steps or to fix the specific problem. Your own Undo (Cmd+Z) takes back only your own steps, not the Agent’s.
- To return to an earlier state, open the board tab’s menu, choose Version history, pick the version before the edit (marked Edited by the agent for the Agent’s own versions), and choose Restore this version.
What the board check reports
| Problem | What to look at |
|---|---|
| Disconnected flow node | A step with no connector in or out |
| Dangling connector | A connector attached to an element that no longer exists |
| Outside its frame, or empty frame | Elements that drifted out of a frame, or frames left with nothing in them |
| Overlap or crossing | Nodes on top of each other, or a connector that crosses a node |
| Label problems | Missing labels, labels that do not fit, or labels that overlap |
| Broken card or picture | A card whose target moved or is missing, or a picture whose data is missing |
Know the boundary of this review
The board check finds structural problems; it does not decide whether a relationship is true or a grouping is sensible. Most problems come with a suggested fix that the Agent can apply, but you still decide whether the result says what you mean. A restore from Version history is itself one change, so you can undo it like any edit.
Other kits can work differently: some offer a Draft mode in the Agent composer, where the Agent edits a draft that you review and then merge or discard. Shell commands have their own approval prompt. If the Agent is using a connected model, review which project information is appropriate to send before starting, and keep a separate source document for factual material.
Version and sources
This guide describes the Kition desktop app as of source 7d49036f, checked on 2026-11-06. Connected actions also depend on the configured model provider or service. If your installed version is older, some controls may differ.
Related pages
Create your first board
A board is an editable canvas for shapes, sticky notes, text, connectors, pictures and frames, saved as a .kboard file in your workspace and edited with the Board kit.
Agent approvals and safety boundaries
Use the shell-command approval card and kit drafts without assuming Kition has a universal per-tool permission editor.
Export a board as PNG, SVG, or PDF
Board export writes a PNG, SVG, or PDF of the shown page or one selected frame as a new file next to the board. Keep the .kboard file when you need to change the diagram later.