Embody¶

Create at the speed of thought¶

Embody puts a team of AI builders inside your live TouchDesigner project. Describe a network in plain language and it gets built — wired, named, annotated, and laid out while you direct. Run several agents in parallel, each scoped to its own part of the network. Branch off the version that works, restore yesterday's state. The tool keeps up with you, instead of the other way around.

Embody is four tools working together — lateral velocity, forward velocity, outward velocity, and the substrate that makes it all possible.

Embody — Lateral Velocity

Tag any operator and Embody externalizes it to files on disk that mirror your network hierarchy. Try a new direction, branch off a good one, restore yesterday's state — all in seconds. Externalized files are the source of truth, so every project opens already in flow.

Get started
Envoy — Forward Velocity

An embedded MCP server with 62 tools that lets Claude Code, Codex, Gemini, Cursor, Windsurf, and GitHub Copilot via VS Code talk directly to your live TouchDesigner session. Say what you want — operators, connections, parameters, extensions, fixes — and watch it happen in your live session. Small changes can land in seconds, depending on your model; a complete network is a 5-20 minute autonomous build you can hand off, parallelize across sessions, and check back on.

Setup Envoy
Convoy — Outward Velocity

Convoy-enabled Embody nodes on a trusted LAN discover, inspect, and control each other — one AI session relaying builds, test runs, saves, screenshots, and restarts to every machine in the room. A small per-user background app keeps each node reachable even while TouchDesigner is closed.

Join the Convoy
TDN — The Substrate

TouchDesigner networks exported as human-readable YAML. The format is what lets your AI agent see what's on screen, what lets you diff one attempt against another, and what lets a network rebuild itself from text. TDN is what makes the rest of this possible.

Learn about TDN

What You Can Do¶

You and your AI assistant, in the same session, with full context of your live network:

	Capability	Example
	Build entire networks from a sentence	"Build me a noise-driven particle system."
	Try a different approach without starting over	"Actually, make it react to audio instead."
	Read & set any parameter	"Set the noise frequency to match the audio input."
	Write extensions	"Create an extension class that manages scene transitions."
	Debug errors	"Why is my render chain producing a black output?"
	Compare attempts side by side	"Show me what changed between this version and the last one."
	Inspect anything	"What parameters are non-default on this operator?"
:material-annotation:	Document networks	"Add annotations to group and label these operators."
	Run tests	"Run the test suite and fix any failures."

You describe what you want. The AI works with your live network — operators, connections, parameters, hierarchy — with the whole picture. And you don't have to run just one: multi-session coordination lets several assistants work the same project at once, each claiming its own scope, aware of the others, gated from collisions — an entire team on your network. The result is a network you can read, revert, and rebuild from text.

Full tool reference

Key Features¶

	Feature	Description
	Automated Externalization	Tag COMPs and DATs — or opt in to auto-tagging what the AI builds — and Embody keeps the external files in sync, auto-restoring from disk on project open
	Envoy MCP Server	62 tools connect AI assistants to your live TD session
	Multi-Session Coordination	Run several AI sessions on one project — scoped claims, peer advisories, and gated destructive operations
	Convoy LAN Relay	Convoy-enabled nodes on a trusted LAN discover, inspect, and control each other — relay test runs, saves, screenshots, and restarts to other machines from one AI session (Convoy guide)
	TDN Format	Export/import operator networks as diffable YAML for code review and snapshots
	Keyboard Shortcuts	Double-tap `Left Ctrl` to tag, `Ctrl`+`Shift`+`U` to save — and every binding is remappable (type or record)
	Parameter Tracking	Automatically detects parameter changes and marks COMPs dirty
	108 Test Suites	Comprehensive automated testing framework (2,407 tests)
	Structured Logging	Multi-destination logging with file rotation, ring buffer, and MCP access

Requirements¶

TouchDesigner 2025.33070 or later (Windows / macOS)
A git repository is optional. Embody works in any project folder; if you happen to use git, every change is also a clean diff for free.

Quick Start¶

Download the Embody .tox from the release folder
Drag and drop it into your TouchDesigner project
Enable Envoy to connect AI assistants to your session
Tag operators by pressing Left Ctrl twice on any COMP or DAT
Save with Ctrl+Shift+U — on next project open, everything restores from disk automatically

Five-minute Quickstart Full setup guide