with one click
manage-annotations
MUST READ before creating, modifying, or querying annotations. Contains parameter names, coordinate model, and API quirks.
Menu
MUST READ before creating, modifying, or querying annotations. Contains parameter names, coordinate model, and API quirks.
| name | manage-annotations |
| description | MUST READ before creating, modifying, or querying annotations. Contains parameter names, coordinate model, and API quirks. |
create_annotation(
parent_path='/path/to/network',
mode='annotate', # 'annotate' (title bar), 'comment', or 'networkbox'
title='My Group',
text='Description of this group',
x=..., y=..., width=..., height=...,
color=[r, g, b], # Optional, floats 0-1
opacity=0.5 # Optional
)
Always favor annotations over OP comments for documenting operators or groups.
To create an annotation that encloses a group of operators:
get_network_layout on the parent COMP (includes all operator positions and bounding box)min_x, max_x, min_y, max_y (max includes operator width/height: max_x = max(op_x + op_w), max_y = max(op_y + op_h))nodeX = min_x - 70nodeY = min_y - 70 (BELOW operators, not above!)nodeWidth = max_x - min_x + 140nodeHeight = max_y - min_y + 240 (70 bottom + 170 top)nodeX/nodeY = bottom-left corner, width/height extend rightward and upwardnodeY above the operators. nodeY must be BELOW (less than) the lowest operator's Y.get_annotations — list all annotations in a COMP with properties and enclosed operatorsget_enclosed_ops — get operators enclosed by an annotation, or annotations enclosing an operatorset_annotation — modify text, title, color, opacity, position, or sizeannotateCOMP Quirksutility property: True from TD UI, False from code. Set ann.utility = True to match TD behavior..type returns 'annotate' (not 'annotateCOMP')findChildren(type=annotateCOMP) requires the class object, not the stringMUST READ before first MCP tool call in a session. Complete Envoy tool catalog with parameters and usage.
Run Embody's test suite and write new tests (Embody development)
MUST READ before calling create_op. Contains required verification, positioning, and error-checking steps.
MUST READ before writing TD Python via execute_python, set_dat_content, or edit_dat_content. API reference for parameters, storage, operators, threading.
Workflow for running multiple TD instances with Envoy, switching between them, and understanding the instance registry.
MUST READ before calling externalize_op or save_externalization. Required workflow steps.