Installation

The clean way to install is to let TouchDesigner open twozero.tox on its own, with no project of yours in the way.

Windows

1. Close your project, then double-click twozero.tox — TouchDesigner opens it as its own project
2. Click GET STARTED
3. Confirm the Windows permission prompt (why?)
4. Open your own project again — twozero is already there

macOS

1. Close your project, then double-click twozero.tox
2. Click GET STARTED
3. If Full Disk Access is not granted yet, the installer stops on One more step and the button becomes OPEN SETTINGS & QUIT TD — it opens System Settings → Privacy & Security → Full Disk Access and closes TouchDesigner. Toggle TouchDesigner on, reopen the .tox — the installer detects the granted permission and finishes on its own ("Permission granted").
4. Open your own project again

Full Disk Access can also be granted up front: System Settings → Privacy & Security → Full Disk Access → TouchDesigner.

Upon successful installation, a launcher icon appears next to the 'Open palette' button.

Dropping it into an open project

Dragging twozero.tox into the network editor of a project you are working in also installs it, and twozero is usable in that session right away — but TouchDesigner has to open a second window for a few seconds to write the system interface file, then closes it by itself. That window is part of the install; let it finish. Double-clicking the .tox skips it entirely, which is why it is the recommended route.

Other things worth knowing

• On an older TouchDesigner build the installer stops and offers GET LATEST TD instead — see System Requirements.
• When the install is done, the agent connection wizard opens automatically so you can hook up Claude Code / Cursor / Codex in one click — see MCP. You can close it and reopen it later from Settings → Reconnect agents.
• The MCP server comes up with TouchDesigner. Settings → MCP → Auto start is on out of the box, so twozero is reachable as soon as TD has finished loading — there is nothing to launch by hand. Turn it off and no agent will find twozero, however many chats you open.
• Start the chat with TouchDesigner already running. An agent connects to twozero once, at the moment the chat starts, and does not retry — a chat that was open before TD came up will not see the twozero tools for the rest of its life, and reconnecting from inside it does not help. Whenever you plan to work with twozero, bring TouchDesigner up first and then open a new chat.

twozero installs once and stays. After installation, it loads automatically every time you open TouchDesigner. No need to add it to individual projects.

If the install didn't go through — or TouchDesigner started behaving oddly afterwards — see Troubleshooting.