tldraw API

Operate the installed tldraw Desktop app through its authenticated localhost API. Prefer this skill over UI automation when the app is running and the task can be expressed as editor records or document scripts.

Start safely

1. Require tldraw Desktop to be running with at least one document open.
2. Run scripts/tldraw_api.sh docs to discover document IDs and file paths.
3. Read the target with shapes before mutating it. Preserve shapes unrelated to the request.
4. Use stable semantic IDs such as shape:payments-api, not random IDs, when reruns may occur.
5. Never print or persist the bearer token. The wrapper reads it dynamically from tldraw's server.json.
6. Never edit an open .tldraw archive directly. Mutate it through /exec or its script workspace, then save through tldraw.

The wrapper requires curl and jq. Set TLDRAW_STATE_FILE only when tldraw stores server.json outside its normal platform location.

Choose the operation