Exchange Runner

Run Ruby scripts inside Autodesk InfoWorks ICM Exchange (or legacy Innovyze IExchange) directly from VS Code / Cursor, then drop into an interactive REPL.

Demo

Run a script and start the REPL:

Evaluate expressions interactively:

Requirements

• Windows (ICM Exchange is a Windows-only application)
• Autodesk InfoWorks ICM with ICMExchange.exe, or Innovyze with IExchange.exe

Getting Started

1. Install the extension.
2. Open any .rb file.
3. Run Exchange Runner: Run Ruby in Exchange from the Command Palette, the run button in the editor title bar, or the right-click context menu (Ctrl+Alt+R).
4. On first run, the extension will discover installed ICM versions and ask you to pick one. You can also browse manually for the executable.

After the script executes, an interactive REPL panel opens. Type Ruby expressions to evaluate them in the ICM context, or type exit to quit.

Changing the Executable

• Run Exchange Runner: Select IExchange executable from the Command Palette at any time.
• Or edit Settings > Exchange Runner > ICM Exchange Path (user or workspace).

Multiple Sessions and Different ICM Versions

You can run different scripts with different ICM versions at the same time (e.g. one window with ICM 2026, another with ICM 2025):

• Workspace setting: Set ICM Exchange Path in the workspace settings (.vscode/settings.json) for each folder. Each workspace can point to a different executable.
• Per-run isolation: Each run uses its own temp directory, so multiple concurrent sessions never interfere with each other.

Supported Executables

Commands

About Masa Lab

Exchange Runner is built by Masa Lab, tools for engineers working with hydraulic and stormwater models.

Visit masalab.io to learn more.