Work in a Desktop project
A Desktop connection lets an external AI coding client use approved tools against the project currently open in RunMat Desktop. Depending on the connection, those tools can read and edit project files, run source, inspect stdout, query workspace variables, view figures, and examine run history.
Connect safely
- Open the intended project and close unrelated sensitive projects.
- Enable the Desktop Agent connection and review its advertised scope.
- Configure the MCP client using the connection details provided by Desktop.
- Ask the client to identify the project and execution location before work begins.
- Approve only the tools required for the task.
- Review changes and run evidence, then disconnect.
Project authorization is not general filesystem authorization. Local file tools remain rooted in the opened project, and Runtime tools operate on its attached session. Nevertheless, source can read data available to the Runtime, so review code before execution when the project can access sensitive resources.
If the client sees stale files or variables, confirm that it is connected to the current Desktop window and project, then refresh tool discovery or reconnect. Do not work around a project mismatch by broadening filesystem permissions.