Skip to content
Back to search

Embody

The most comprehensive MCP toolkit for TouchDesigner

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dylanroscover/Embody with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dylanroscover/Embody'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dylanroscover--embody/badge.svg)](/listings/dylanroscover--embody)

HTML

<a href="/listings/dylanroscover--embody"><img src="/api/listings/dylanroscover--embody/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Requirements:** TouchDesigner **2025.33230 or later** (Windows / macOS). No Python setup needed — Embody builds a per-project Python environment (`.venv`) matched to TouchDesigner's own interpreter, and [your own packages can live in it too](https://dylanroscover.github.io/Embody/embody/python-environment/). No special folder structure either: Embody works in any project folder, and if you happen to use git, every change is also a clean diff for free.

1. Install

**Download** the Embody `.tox` from [`/release`](release/) and drag it into your TouchDesigner project. The **[Setup Wizard](https://dylanroscover.github.io/Embody/embody/setup-wizard/)** opens and walks you through the choices that matter — how much autonomy Embody gets, what to externalize, whether to enable the AI assistant (Envoy) and for which tool, permissions, whether to join a trusted-LAN Convoy, and where config files live. Nothing changes until the final click, and you can re-run it anytime via the **Setup Wizard** pulse on the Embody COMP.

> **Updating Embody:** Embody updates itself — pulse **Check for Update** on the About page (or set **Auto-Update** to check at startup), and a verified release is downloaded, backed up against, and swapped in place. Your settings and tracked externalizations live on disk and survive the update untouched. See the [auto-update guide](https://dylanroscover.github.io/Embody/embody/auto-update/). Manual alternative: delete the old Embody COMP and drag the new `.tox` in its place — the new version picks up your on-disk state automatically, no re-scan, no files rewritten.

Provisioning a machine with no one at it (a render node, a media server)? The [bootstrap](https://dylanroscover.github.io/Embody/envoy/provisioning/) installs Embody into a `.toe` offline with TouchDesigner's own tools, in one line.

2. Tag and Work

1. **Tag operators** — hover any COMP or DAT and press `lctrl` twice to open the tagger (pick a strategy for a COMP, a file format for a DAT) 2. **Work normally** — press `ctrl + shift + u` to update all externalizations, or `ctrl + alt + u` to update only the current COMP. Externalized files are written on save; on open, the `.toe` stays authoritative by default (Export-on-Save), while Roundtrip mode also reconstructs TDXN-strategy COMPs from disk

> **Tip:** Externalization is opt-in — nothing is written to disk until you tag it. To capture your AI assistant's work automatically, set **Auto-Externalize New Ops** (Envoy parameter page) and everything it creates through Envoy is tagged and externalized as it's built.

For supported formats, folder configuration, duplicate handling, Manager UI, and more — see the [Embody docs](https://dylanroscover.github.io/Embody/embody/).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 279 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="docs/assets/embody-mark.svg" alt="Embody" width="96" height="96">
  3. # Embody
  4. **create at the speed of thought.**
  5. [![Version](https://img.shields.io/badge/version-6.3.6-6ee668?style=flat-square&labelColor=181e1e)](https://github.com/dylanroscover/Embody/releases/latest)
  6. [![TouchDesigner](https://img.shields.io/badge/TouchDesigner-2025-6ee668?style=flat-square&labelColor=181e1e)](https://derivative.ca/)
  7. [![MCP Tools](https://img.shields.io/badge/MCP_tools-70-6ee668?style=flat-square&labelColor=181e1e)](https://modelcontextprotocol.io/)
  8. [![License](https://img.shields.io/badge/license-MIT-6ee668?style=flat-square&labelColor=181e1e)](LICENSE)
  9. [![GitHub Stars](https://img.shields.io/github/stars/dylanroscover/Embody?style=flat-square&labelColor=181e1e&color=6ee668)](https://github.com/dylanroscover/Embody/stargazers)
  10. [![Downloads](https://img.shields.io/github/downloads/dylanroscover/Embody/total?style=flat-square&labelColor=181e1e&color=6ee668)](https://github.com/dylanroscover/Embody/releases)
  11. [**embody.tools**](https://embody.tools) &nbsp;&middot;&nbsp; [Documentation](https://dylanroscover.github.io/Embody/) &nbsp;&middot;&nbsp; [Manifesto](https://dylanroscover.github.io/Embody/manifesto/) &nbsp;&middot;&nbsp; [Changelog](https://dylanroscover.github.io/Embody/changelog/)
  12. <img src="docs/assets/embot.gif" alt="Embot, Embody's mascot, hovering, blinking, and waving" width="120">
  13. <sub>**Embot** — he hops through your network while Envoy builds</sub>
  14. </div>
  15. ---
  16. Embody puts your ideas on screen as fast as you can describe them. Operators, connections, parameters, the works. Want to try a different direction? Spin up a new approach in seconds. Compare attempts side by side. Branch off the one that works. **The tool keeps up with you, instead of the other way around.**
  17. ## Four Tools, One Idea
  18. **[Envoy](https://dylanroscover.github.io/Embody/envoy/)** — *forward velocity.* An embedded [MCP](https://modelcontextprotocol.io/) server lets [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [OpenCode](https://opencode.ai/), [Gemini](https://github.com/google-gemini/gemini-cli), [Cursor](https://www.cursor.com/), [Windsurf](https://windsurf.com/), and [GitHub Copilot](https://github.com/features/copilot) (via VS Code) talk directly to your live TouchDesigner session. Create operators, wire them up, set parameters, write extensions, debug errors — by saying what you want. No copy-pasting code. No describing your network in chat. Idea → operators in seconds.
  19. **Embody** — *lateral velocity.* Tag any operator and Embody [externalizes it](https://dylanroscover.github.io/Embody/embody/getting-started/) to files on disk that mirror your network hierarchy. Try a new direction, branch off a good one, restore the state from yesterday — all in seconds. Your externalized files are the source of truth, so every project opens already in flow.
  20. **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, files, and restarts to every machine in the room. A small per-user background app keeps each computer reachable even while TouchDesigner is closed, so a closed project can be started remotely. [Convoy guide](https://dylanroscover.github.io/Embody/convoy/)
  21. **[TDXN](https://dylanroscover.github.io/Embody/tdxn/)** — *the substrate that makes it all possible.* TouchDesigner networks exported as human-readable YAML. The format is what lets your AI agent understand what's on the screen, what lets you diff one attempt against another, and what lets a network reconstruct itself from text on the next project open. TDXN is what makes the rest of this possible.
  22. ![Embody Manager UI](docs/assets/embody-screenshot.png)
  23. | | What | Why it matters |
  24. |---|---|---|
  25. | 🤖 | **Envoy MCP Server** | 70 tools let your AI assistant build, wire, parameterize, and debug live networks. The first time you watch it happen, you stop typing operator names by hand for good. |
  26. | 📄 | **TDXN Network Format** | Networks become text. Diff two versions, revisit any version, hand an LLM a complete picture of what's on screen — all from a single `.tdxn` file. |
  27. | 📦 | **Automatic Restoration** | Externalized files are written on save, so any COMP can be recovered from disk. By default (Export-on-Save) the `.toe` stays authoritative on open; switch to Roundtrip mode to rebuild TDXN-strategy COMPs from `.tdxn` on every open. |
  28. | 📤 | **Portable Tox Export** | Pull any COMP out as a self-contained `.tox` with external references stripped. Ship a piece of your project anywhere. |
  29. | 🐍 | **Project Python Environment** | One `.venv` per project, built against TouchDesigner's own interpreter — Envoy runs from it, your packages import inside TD from it, and AI agents manage it hands-free. [Python Environment](https://dylanroscover.github.io/Embody/embody/python-environment/) |
  30. | 🛰️ | **Convoy LAN Relay** | Convoy-enabled Embody nodes on a trusted LAN discover, inspect, and control each other through Envoy — relay test runs, saves, screenshots, and restarts to other machines from one AI session. [Convoy guide](https://dylanroscover.github.io/Embody/convoy/) |
  31. ---
  32. ## Quick Start
  33. **Requirements:** TouchDesigner **2025.33230 or later** (Windows / macOS). No Python setup needed — Embody builds a per-project Python environment (`.venv`) matched to TouchDesigner's own interpreter, and [your own packages can live in it too](https://dylanroscover.github.io/Embody/embody/python-environment/). No special folder structure either: Embody works in any project folder, and if you happen to use git, every change is also a clean diff for free.
  34. ### 1. Install
  35. **Download** the Embody `.tox` from [`/release`](release/) and drag it into your TouchDesigner project. The **[Setup Wizard](https://dylanroscover.github.io/Embody/embody/setup-wizard/)** opens and walks you through the choices that matter — how much autonomy Embody gets, what to externalize, whether to enable the AI assistant (Envoy) and for which tool, permissions, whether to join a trusted-LAN Convoy, and where config files live. Nothing changes until the final click, and you can re-run it anytime via the **Setup Wizard** pulse on the Embody COMP.
  36. > **Updating Embody:** Embody updates itself — pulse **Check for Update** on the About page (or set **Auto-Update** to check at startup), and a verified release is downloaded, backed up against, and swapped in place. Your settings and tracked externalizations live on disk and survive the update untouched. See the [auto-update guide](https://dylanroscover.github.io/Embody/embody/auto-update/). Manual alternative: delete the old Embody COMP and drag the new `.tox` in its place — the new version picks up your on-disk state automatically, no re-scan, no files rewritten.
  37. Starting a brand-new project? Copy [`starter/Embody-starter.toe`](starter/) into an empty folder, rename it and open it: it is a blank project that downloads and verifies the latest release into itself on first open, and asks for a release `.tox` if there is no connection.
  38. Provisioning a machine with no one at it (a render node, a media server)? The [bootstrap](https://dylanroscover.github.io/Embody/envoy/provisioning/) installs Embody into a `.toe` offline with TouchDesigner's own tools, in one line.
  39. ### 2. Tag and Work
  40. 1. **Tag operators** — hover any COMP or DAT and press `lctrl` twice to open the tagger (pick a strategy for a COMP, a file format for a DAT)
  41. 2. **Work normally** — press `ctrl + shift + u` to update all externalizations, or `ctrl + alt + u` to update only the current COMP. Externalized files are written on save; on open, the `.toe` stays authoritative by default (Export-on-Save), while Roundtrip mode also reconstructs TDXN-strategy COMPs from disk
  42. > **Tip:** Externalization is opt-in — nothing is written to disk until you tag it. To capture your AI assistant's work automatically, set **Auto-Externalize New Ops** (Envoy parameter page) and everything it creates through Envoy is tagged and externalized as it's built.
  43. For supported formats, folder configuration, duplicate handling, Manager UI, and more — see the [Embody docs](https://dylanroscover.github.io/Embody/embody/).
  44. ---
  45. ## Envoy MCP Server
  46. Embody includes **Envoy**, an embedded [MCP](https://modelcontextprotocol.io/) server that gives AI coding assistants direct access to your live TouchDesigner session.
  47. ### Setup
  48. 1. **Pick an AI assistant in the [Setup Wizard](https://dylanroscover.github.io/Embody/embody/setup-wizard/)** — it opens on first install, or re-run it anytime (the **Setup Wizard** pulse on the Embody COMP). Prefer parameters? Toggling **Envoy Enable** (`Envoyenable`) does the same thing with your current settings
  49. 2. **Server starts** on `127.0.0.1:9870` (configurable via `Envoyport`; if the port is taken by another instance, Envoy scans forward automatically)
  50. 3. **Auto-configuration** — Envoy writes a `.mcp.json` (STDIO bridge, so tools are available even before TD is running) at your AI project root. By default that's the git repo root; the wizard's config-location step — or the `Aiprojectroot` parameter — can point it at the `.toe` folder or a custom path instead. Projects without a git repo still get config generated in the `.toe` folder
  51. 4. **Connect** — open a Claude Code session (or restart your IDE) at that root — it picks up `.mcp.json` automatically
  52. The generated config runs Envoy's bridged STDIO transport (recommended — it can launch and restart TD for you). If you'd rather wire a client by hand, the direct HTTP transport works whenever TD is running:
  53. ```json
  54. {
  55. "mcpServers": {
  56. "envoy": {
  57. "type": "http",
  58. "url": "http://127.0.0.1:9870/mcp"
  59. }
  60. }
  61. }
  62. ```
  63. ### Tools at a Glance
  64. | Tool | What It Does |
  65. |------|-------------|
  66. | `create_op` | Create any operator type in any network |
  67. | `set_parameter` | Set values, expressions, or bind modes on any parameter |
  68. | `connect_ops` | Wire operators together |
  69. | `execute_python` | Run arbitrary Python in TD's main thread |
  70. | `export_network` | Export networks to diffable `.tdxn` YAML |
  71. | `create_extension` | Scaffold a full extension (COMP + DAT + wiring) |
  72. | `get_op_errors` | Inspect errors on any operator and its children |
  73. ...and 56 more. See the [full tools reference](https://dylanroscover.github.io/Embody/envoy/tools-reference/).
  74. When Envoy starts, it always generates an `AGENTS.md` file in your project root with TD development patterns and project-specific guidance. It also writes a client-specific config for whichever assistant you select in the `Aiclient` parameter (`CLAUDE.md` + `.claude/` for Claude Code, `opencode.json` + `.claude/` for OpenCode, Cursor/Windsurf rules, Copilot instructions, `GEMINI.md` for Gemini; Codex and OpenCode read `AGENTS.md` directly). For OpenCode and local-model setups, see the [Local Models & Open Clients](https://dylanroscover.github.io/Embody/envoy/local-models/) guide.
  75. ---
  76. ## TDXN Network Format
  77. TDXN (TouchDesigner eXternal Network) is the file format that makes the rest of Embody possible. It exports an entire operator network — operators, connections, parameters, layout, annotations, DAT content — as a single human-readable YAML file. Your AI agent can read it. You can read it. Any text tool can diff it. The network can rebuild itself from it.
  78. This is the substrate. Every other capability — AI-driven building, version control, automatic restoration — builds on top of it.
  79. - **Entire project**: `ctrl + shift + e`
  80. - **Current COMP**: `ctrl + alt + e`
  81. - **Via Envoy**: `export_network` / `import_network` MCP tools
  82. See the [full TDXN specification](https://dylanroscover.github.io/Embody/tdxn/specification/) for format details, import process, and round-trip guarantees.
  83. ---
  84. ## Keyboard Shortcuts
  85. | Shortcut | Action |
  86. |----------|--------|
  87. | `lctrl + lctrl` | Tag or manage the operator under the cursor |
  88. | `ctrl + shift + u` | Update all externalizations |
  89. | `ctrl + alt + u` | Update only the current COMP |
  90. | `ctrl + shift + r` | Refresh tracking state |
  91. | `ctrl + shift + o` | Open the Manager UI |
  92. | `ctrl + shift + c` | Copy the selected COMP to the clipboard as a portable TDXN envelope |
  93. | `ctrl + shift + e` | Export entire project to `.tdxn` file |
  94. | `ctrl + alt + e` | Export current COMP to `.tdxn` file |
  95. These are the defaults — every shortcut is editable on the Embody COMP's **Shortcuts** parameter page (type a combo, or pulse **Record** and press the keys; empty disables it). See [Keyboard Shortcuts](https://dylanroscover.github.io/Embody/embody/keyboard-shortcuts/).
  96. ---
  97. <details>
  98. <summary><strong>Where externalized files go</strong></summary>
  99. Embody writes externalized files relative to your `.toe` location, mirroring your network hierarchy — no special folder structure required:
  100. ```
  101. my-project/ ← project folder (optionally a git repo)
  102. ├── my-project.toe ← your TouchDesigner project
  103. ├── base1/ ← externalized operators
  104. │ ├── base2.tox ← COMP (TOX strategy)
  105. │ ├── base3.tdxn ← COMP (TDXN strategy — diffable YAML)
  106. │ └── text1.py ← DAT
  107. └── ...
  108. ```
  109. </details>
  110. <details>
  111. <summary><strong>Logging</strong></summary>
  112. Embody provides a multi-destination logging system:
  113. - **File logging** (default): `dev/logs/<project_name>_YYMMDD.log`, auto-rotates at 10 MB
  114. - **FIFO DAT**: Recent entries visible in the TD network editor
  115. - **Textport**: Enable the `Print` parameter to echo logs
  116. - **Ring buffer**: Last 200 entries via the Envoy `get_logs` MCP tool
  117. ```python
  118. op.Embody.Log('Something happened', 'INFO')
  119. op.Embody.Warn('Check this out')
  120. op.Embody.Error('Something broke')
  121. ```
  122. </details>
  123. <details>
  124. <summary><strong>Testing</strong></summary>
  125. Embody includes **168 test suites** (5,735 tests) covering core externalization, MCP tools, TDXN format, the Envoy server/bridge, launch/config generation, install/uninstall paths, self-update, release hooks, the status readout, and palette catalogs. Tests run inside TouchDesigner using a custom test runner with sandbox isolation. Destructive whole-project suites are segregated and run only via the save-gated `RunDestructiveTests`.
  126. ```python
  127. op.unit_tests.RunTests() # All tests (non-blocking)
  128. op.unit_tests.RunTests(suite_name='test_path_utils') # Single suite
  129. op.unit_tests.RunTestsSync() # All in one frame (blocks TD)
  130. ```
  131. Via Envoy MCP: use the `run_tests` tool. See the [full testing docs](https://dylanroscover.github.io/Embody/testing/) for coverage details and how to write new tests.
  132. </details>
  133. <details>
  134. <summary><strong>Troubleshooting</strong></summary>
  135. - **Timeline Paused**: Embody requires the timeline to be running. An error appears if paused.
  136. - **Clone/Replicant Operators**: Cannot be externalized. Embody warns if you try to tag them.
  137. - **Engine COMPs**: Engine, time, and annotate COMPs are not supported for externalization.
  138. For more, see [Troubleshooting](https://dylanroscover.github.io/Embody/embody/troubleshooting/).
  139. </details>
  140. ---
  141. ## Version History
  142. Every release is documented in the [full changelog](https://dylanroscover.github.io/Embody/changelog/). Highlights:
  143. - **6.3.6** — a starter project that installs Embody into itself on first open, the dragged-in `.tox` question moves into the setup wizard, and bootstrapped projects come up enabled so `externalize_op` writes
  144. - **6.3.3** — Convoy is set up once per computer: machines stay on with no project open, a version-up keeps a node's address and approvals, and the page lists one row per machine
  145. - **6.2.77** — the update-complete dialog offers Save Now, so the saved `.toe` keeps the new Embody
  146. - **6.2.76** — Externalize Full Project keeps Embody and TouchDesigner's own COMPs out of your files, older over-tagged projects clean up after the update, and a project saved before its first externalization reopens with its tracking (issue #176)
  147. - **6.2.73** — a `.mcp.json` Embody cannot parse is left untouched instead of replaced, so your other MCP servers survive (issue #159)
  148. - **6.2.72** — Convoy switches branches, uses optional sibling worktrees and sends files to a node (`convoy_send_file`), and a pull no longer moves a different branch; TDXN format 2.2 and self-contained clipboard copies
  149. - **6.2.71** — parent `.tdxn` files stop repeating the custom parameters of children that have their own `.tdxn` (a 15-COMP lab's child entries shrink from 2,368 lines to 72); importing a COMP from its own `.tdxn` creates its custom parameters before its contents
  150. - **6.2.69** — a session whose TouchDesigner closes stops with `envoy.instance.unavailable` instead of drifting into another open project; saves that rename the `.toe` are followed, and `launch_td` / `restart_td` act on the session's own instance (issue #147)
  151. - **6.2.68** — a manual Check for Update offers Install Anyway when a release was built for a newer TouchDesigner than yours; unattended updates still stop at the floor (issue #145)
  152. - **6.2.65** — four new skills (`glsl-shaders`, `operator-gotchas`, `testing`, `/collab`) and skill reference files, with thanks to Derivative's TDMCPSkills; `describe_op_type` and `run_soak_test`; a user project's always-loaded guidance cut by 40%
  153. - **6.2.64** — Forget Offline Nodes clears rows fleet-wide, each by its owner; silent nodes retire after a week instead of a month; update jobs no longer report a false failure
  154. - **6.2.63** — the Windows supervisor stays armed after an install; node rows carry the TD build and the fleet update its runtime id; a live-but-silent node reads stalled; a mid-scan readout clears on reopen
  155. - **6.2.62** — a re-minted host's ghost record goes dormant on its peers instead of being dialed forever; the pin stays, contact wakes it, and Status names the ghost on both sides
  156. - **6.2.61** — Convoy names its Envoy dependency and the host's advisories (rejected certificates, re-minted identities, realm splits, VPN binds), re-pins changed peers, avoids VPNs and public networks on auto-bind, and rejoins admitted peers' realm instead of founding one
  157. - **6.2.59** — a fresh clone keeps the Envoy it adopts; a rollback no longer claims the version it discarded; the release gate's identity check stopped failing healthy builds and passing on runtime tables
  158. - **6.2.57** — TDXN exports operator references as authored and rebases in-project absolute paths (fixes #132); a fresh clone adopts the committed Envoy declaration; one-command fresh-install release smoke, with the macOS leg in CI
  159. - **6.2.56** — a venv whose Python stops running is repaired in place instead of deleted, on a background thread, keeping installed packages; enabling Envoy no longer freezes TD; devalue security bump
  160. - **6.2.55** — new specimen Serenity and Beauty with a cover video; enabled clones of a sibling COMP export as their values (the mandala `.tdxn` 9,599 → 2,834 lines); embody.tools source viewer renders in the browser; Embot allowed in TDXN COMPs; new shipped rule `tdxn-economy`
  161. - **6.2.52** — tuplet custom parameters (RGB, XYZ, multi-component Float/Int) at a non-zero default import with that value instead of 0
  162. - **6.2.51** — seven agent-rule gotchas from issue #94 verified live before shipping; embody.tools covers come from the specimen row, never a baked list; new specimen Prismatic Strata
  163. - **6.2.50** — `Export Release Toe`: one pulse prompts, asks where, then ships the project as a locked `.toe`; Embody can write the `pre_release_toe` hook for you
  164. - **6.2.49** — saves say what a `.tdxn` cannot hold, headers stay visible in VS Code, and Envoy can no longer freeze TouchDesigner by deleting its own host (issues #106, #108–#110)
  165. - **6.2.42** — `ExportReleaseToe`: ship the whole project as one locked `.toe` with Embody removed, preview first
  166. - **6.2.41** — the MCP SDK moves to 2.2.0; existing venvs upgrade themselves on the next start
  167. - **6.2.40** — the TDXN tag, the `strategy` column, the files on disk and the git diff driver all say TDXN; nine strategy reads that had silently stopped matching are fixed
  168. - **6.2.13** — vector custom parameter defaults survive the round trip (issue #96); six definition fields, three authored flags, and TDXN format 2.1
  169. - **6.2.8** — the TDXN rename completes across docs, skills, and embody.tools (`/tdn/` → `/tdxn/` with permanent redirects)
  170. - **6.2.5** — TDXN review fixes: snapshot exports never touch tracked files, and dirty detection covers everything an export writes
  171. - **6.2.0** — three namespace tiers; the promoted surface drops from 214 members to 43 (issue #94 — **breaking** for undocumented names)
  172. - **6.1.5** — every AI client gets the MCP config it actually reads, from one registry; edit protection rides inside generated files
  173. - **6.1.2** — the format becomes **TDXN** (TouchDesigner eXternal Network); existing `.tdn` files work unchanged, with an opt-in migration pulse
  174. - **6.0.201–6.0.280** — the Convoy hardening arc: macOS enablement, a self-updating daemon, fleet-wide Embody updates, and a self-updater that can no longer be latched by a stuck download
  175. - **6.0.171** — Convoy ships end to end: nodes on a trusted LAN discover, relay work to, and control each other
  176. - **6.0.162** — MCP SDK 2.0 port with self-upgrading venvs
  177. - **6.0.145** — self-update ships: manifest-gated, verified, backup + rollback
  178. ---
  179. ## Contributors
  180. Originally derived from [External Tox Saver](https://github.com/franklin113/External-Tox-Saver) by [Tim Franklin](https://github.com/franklin113/). Refactored entirely by Dylan Roscover, with inspiration and guidance from Elburz Sorkhabi, Matthew Ragan and Wieland Hilker.
  181. Want to help? Start with [CONTRIBUTING.md](CONTRIBUTING.md) — this repo works differently from a typical Python project (TouchDesigner writes many of the files), and that page explains what is safe to change and how to run the tests.
  182. ## Credits
  183. Embody stands on other people's work, and this section names it. Ideas move
  184. between the TouchDesigner MCP projects in both directions; where Embody took
  185. one, it is credited here and in the code where it landed.
  186. - **[External Tox Saver](https://github.com/franklin113/External-Tox-Saver)** by [Tim Franklin](https://github.com/franklin113) -- Embody began in 2020 as a refactor of it.
  187. - **[TDMCP](https://github.com/TouchDesigner/TDMCP)** by [Derivative](https://derivative.ca) (their MCP server, used with permission while it was private, public since September 2026) -- undoable MCP mutations (one undo step per batch), the `get_docs` design (version-exact offline help first, the wiki API second), sequence-block growth on parameter writes, the transport-security hardening prompt, and treating a code-review rule as a query. Landed from v6.0.87 (2026-07-04) on.
  188. - **[TDMCPSkills](https://github.com/TouchDesigner/TDMCPSkills)** by [Derivative](https://derivative.ca) (used with permission) -- the `pop-networks` skill is adapted from `td-pop-family`; `glsl-shaders` and `operator-gotchas` were written against their `td-glsl-shaders` and family skills as a topic checklist, with every claim re-verified live on TD 2025.33230 (2026-09-25).
  189. - **[touchdesigner-mcp](https://github.com/8beeeaaat/touchdesigner-mcp)** by [8beeeaaat](https://github.com/8beeeaaat) -- the first widely used TouchDesigner MCP server (2025). Envoy's earliest tool vocabulary (`get_td_classes`, `get_td_class_details`, `get_td_info`, `get_module_help`, `exec_node_method`, `execute_python`) follows the names that project established.
  190. - **[td-mcp-rs](https://github.com/Verbalize-public/td-mcp-rs)** by [asyade](https://github.com/asyade) -- a Rust-daemon take on the same problem (2026). Its OS-dialog dismissal, per-call instance addressing, stable error codes with fix hints, any-family capture through an OP Viewer TOP, shader lint on DAT writes, and offline installation into a project file are ideas Embody adopted and built (see the [roadmap](docs/roadmap.md)).
  191. If Embody carries an idea of yours and this list misses it, [open an issue](https://github.com/dylanroscover/Embody/issues) and it will be added.
  192. ## Trademarks and Affiliation
  193. Embody is an independent open-source project. It is not affiliated with, endorsed by, or sponsored by Derivative. TouchDesigner is a trademark of Derivative.
  194. ## License
  195. [MIT License](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.