Create a new empty .tldr file with one default page. Errors if file exists unless overwrite=true.

Create a rectangle shape on the main page. Returns its id.

Create a text shape on the main page. Returns its id.

List shapes (id, type, x, y, label only - props omitted to save tokens).

Get the full record of a single shape by id.

Update a shape via shallow merge. Pass nested {"props": {...}} to update props.

Delete a shape by id.

Connect two shapes with an arrow. Arrow position is binding-driven (start/end stored as 0,0 fallback). Returns arrow id + binding ids.

Group existing shapes into a new group. Reparents the given shape ids under a new group shape.

Dissolve a group: reparent its children to the group's parent and delete the group shape.

Create a new page in the document. Returns the new page id.

List all pages with id, name, and ordering index.

Move shapes to a different page by reparenting them. Note: arrows and bindings should move together for correctness.

List supported tldraw shape types and their required props. Use this to discover what can be created before falling back to exec_jq.

Escape hatch: run a jq filter against the .tldr JSON. Set write=true to persist (auto-checkpoints first).

Copy the .tldr file to a timestamped backup. Returns the backup path.

List checkpoint backups for a .tldr file, newest first.

Restore a checkpoint over the .tldr file. Omits checkpoint to restore the most recent.