Skip to content

MASFactory Visualizer

MASFactory Visualizer is the VS Code companion for MASFactory. It aligns graph structure and runtime observability in a single view, so you can preview, debug, and handle human-in-the-loop interactions with consistent mental models.

This page is a quick-start overview. For full details, see: Dev Guide · MASFactory Visualizer.


What it provides

  • Preview: Inspect graph topology parsed from Python/JSON (subgraphs, loops, switches, etc.).
  • Vibe: Preview/edit graph_design.json for VibeGraphing iterations.
  • Run / Debug: Track node states, message events, and errors at runtime.
  • Human-in-the-loop: Receive user requests (chat / file preview & edit) and send replies back to the running process.

Two ways to open it

Visualizer supports two entry points, backed by the same parsing and runtime data source:

  1. Sidebar (Activity Bar)

Click MASFactory Visualizer in the Activity Bar to open the Graph Preview view.

side-bar

  1. Editor Tab (Webview Panel)

Run in Command Palette:

  • MASFactory Visualizer: Start Graph Preview
  • MASFactory Visualizer: Open Graph in Editor Tab

Or click the top-right action button in a .py / .json editor tab:

editor-button

overview


Typical workflow

  1. Open a .py file that builds a MASFactory graph;
  2. Open Visualizer and switch to Preview;
  3. If you use VibeGraphing: generate/update graph_design.json, then iterate in Vibe;
  4. Run your workflow and inspect Run / Debug for runtime traces and user requests.

For full layout and per-tab functionality, see: Dev Guide · MASFactory Visualizer.