touchdesigner-bridge
Command-Line Tool for Inspecting and Editing a Running TouchDesigner
起動中のTouchDesignerを、外部のシェルから調査・編集するためのコマンドラインツールである。Claude CodeやCodex CLI、Cursorのようにコマンドを実行できるエージェントと、シェルスクリプトから使うことを想定している。MITライセンスのオープンソースとしてGitHubで公開している。
TouchDesignerの起動、処理の重いオペレーターの特定、エラーの一覧、パラメーターやCHOPの値の読み取り、TOPの画像の取得、変更前後のフレームの比較、ネットワークの構築などを、それぞれ1つのコマンドで行える。画面で見て確かめる情報をコマンドラインからも取得できるため、エージェントとユーザーが同じプロジェクトを見ながら制作を進められる。
MCPサーバーは使わず、一時フォルダのファイルを介してTouchDesignerとやり取りする。ポートを開かないので、ネットワーク上の他のマシンからは接続できない。出力は短いテキストで、既定値から変更されたパラメーターだけを返し、行数にも上限を設けることで、エージェントが消費するトークンを抑えている。必要なものはPython 3の標準ライブラリとTouchDesignerのみで、Windows、macOS、WSLで動作する。
デモ映像のプロジェクトは、空の状態から、Claude Fable 5.2へのプロンプトのみで作成した。
A command-line tool for inspecting and editing a running TouchDesigner from an outside shell. It is made for agents that run commands, such as Claude Code, Codex CLI and Cursor, and for shell scripts. It is open source under the MIT License and available on GitHub.
Launching TouchDesigner, finding heavy operators, listing errors, reading parameter and CHOP values, grabbing the image of a TOP, comparing a frame with and without a change, and building networks each take a single command. What a user would check on screen is also available from the command line, so an agent and a user can work on the same project together.
It uses no MCP server and talks to TouchDesigner through files in the temp folder. No port is opened, so other machines on the network cannot reach it. Output is short text: only non-default parameters are returned and line counts are capped, which keeps the agent's token use low. It requires only the Python 3 standard library and TouchDesigner, and runs on Windows, macOS and WSL.
The project in the demo video was built from an empty state using only prompts to Claude Fable 5.2.