Skip to main content

Reviewing Canvas Edits

Whenever the assistant, a canvas component, or an external MCP client wants to modify your Grasshopper canvas — placing or updating components, wiring parameters, moving, grouping, or removing objects — SmartHopper shows you a review dialog first. Nothing changes your definition silently.

How the review dialog works​

  1. The AI proposes a change (for example, placing new components with gh_put, wiring parameters with gh_connect, or tidying a layout with gh_tidy_up).
  2. The review dialog lists every proposed item — components to add, update, or remove, wires to create or disconnect, and groups to form. If a component name in the proposal resolves to a different Grasshopper component type than expected, the row warns Resolves to "<type>" so you can spot it immediately.
  3. You choose which changes to include:
    • Check or uncheck individual rows, or use Select all / Select none to toggle the selection (nothing is applied to the canvas until you confirm).
    • If a selected item depends on another row that you unchecked (such as a wire connected to a component you unchecked), the summary tells you how many selected items will be skipped because their required items are unchecked.
  4. Click Apply selected (or cancel to discard the proposal).
  5. Full Ctrl+Z undo: Every applied change is recorded as a standard Grasshopper undo event, so pressing Ctrl+Z reverts it just like any manual edit.

Where canvas review applies​

  • Canvas Assistant & AI Chat component — every tool call that modifies the canvas pauses for your review.
  • Canvas-editing components — Place GhJSON (GhPut), Apply GhPatch to Canvas (GhPatchApplyCanvas), Tidy Up (GhTidyUp), and AI Smart Connect (AIGhConnect) all use the same review dialog.
  • SmartHopper MCP Server — canvas edits requested by external MCP clients go through the review dialog by default unless you explicitly set Auto-approve changes (AA) to True on the MCP Server component.