Visualize your InterSystems server configurations using Structurizr
gj :: configExplorer is a new VS Code extension integrating with Server Manager and leveraging Structurizr to produce configuration diagrams of your servers.
Here's a short introductory video.
By using the InterSystems IRIS Native API for Node.js it avoids the need for any support code to be installed on the servers. This technology choice also qualifies it for entry into the current Developer Community contest.
The initial release focuses on two aspects of server configuration:
- Namespaces and databases
- ECP connectivity
Suggestions for what to add next are welcome, as is general feedback.
Comments
This comment no longer applies as of version 0.0.4 of the extension, published 2025-11-23.
It's worth noting that the extension can't currently run on Windows without crashing VS Code's extension host (EH) process and thus impacting all other extensions. More information here, which I hope qualifies my entry for the 'Find a bug in InterSystems IRIS External Languages Offerings' bonus.
For Windows users there's a workaround, as long as you have SSH access to a Linux host on which you can run Docker containers. Here's what to do:
Launch VS Code on your Windows desktop.If you don't already have it, install the 'Remote - SSH' extension from Microsoft.From Command Palette run `Remote-SSH: Connect Current Window to Host...`.Enter your SSH connection string in the form `user@host`.When prompted for your password (top centre), enter it.Wait for the progress notifications (lower right) to complete and for the Remote panel on the status bar (far left) to confirm that you are connected.In Extensions view, find gj :: configExplorer and install it. This action will install it on the Linux server for use of the account you connected there with. It also installs Server Manager if necessary.
When operating this way gj :: configExplorer executes in an EH on your Linux server. Connections to the target servers' superserver ports will originate from there, not from your Windows device. Resolving the server names / addresses will behave accordingly.
Great work John Murray !
if you use Docker Desktop on Windows with WSL2, you can use the WSL-Machine as Linux Host for the Workaround. No extra Linux-Host or virtual machine needed!
@John Murray
When will it be available to 64 bit VS Code? I am getting the following warning...
The 'gj :: configExplorer' extension is not available in Visual Studio Code for the Windows 64 bit.
As noted in the original post, when a Windows version of the VSIX is built and used it crashes VS Code's extension host process. I have a WRC open for this, as I suspect there's a problem with how the Windows variant of the InterSystems API package has been built.
Meanwhile maybe try the steps in https://community.intersystems.com/post/how-windows-users-can-try-gj-co…
Or use the tip at https://community.intersystems.com/post/visualize-your-intersystems-ser… from @Thomas Wuppermann
I'm pleased to announce that InterSystems fixed the issue preventing this extension from working in VS Code on Windows. A new Windows-compatible release of the extension (0.0.4) is now available on Marketplace.