/viz

/comfy-viz — Visualize a Workflow

The user wants to visualize a ComfyUI workflow as a mermaid flowchart diagram.

Instructions

1. Get the workflow JSON. The argument may be: $ARGUMENTS

   • A file path to a workflow JSON file — read it with the Read tool
   • Inline JSON pasted directly as the argument
   • Nothing — ask the user to provide a workflow file path or paste the JSON

2. Validate the input. The workflow must be in ComfyUI's API format: an object where keys are node IDs and values have class_type and inputs. If it looks like the web UI format (has nodes and links arrays), tell the user it needs to be in API format and suggest they export it via "Save (API Format)" in ComfyUI.

3. Visualize. Use the visualize_workflow tool with:

   • workflow: the parsed workflow JSON
   • show_values: true (to include parameter values in node labels)
   • direction: "LR" (left-to-right, easiest to read)

4. Present the diagram. Show the mermaid output to the user. The mermaid code block will render as a flowchart showing nodes grouped by category with labeled connections.

Example

User: /comfy-viz ~/workflows/my-workflow.json

Steps:

• Read the file at ~/workflows/my-workflow.json
• Pass contents to visualize_workflow
• Display the mermaid diagram

Notes

• If the workflow is very large (50+ nodes), suggest using direction: "TB" (top-to-bottom) for better readability
• The diagram groups nodes into subgraphs by category: loading, conditioning, sampling, image, output
• Connection edges are labeled with data types (MODEL, CLIP, CONDITIONING, LATENT, IMAGE, VAE, etc.)