comfyui-mcp/plugin/commands/viz.md

Local-first, agent-native control plane for ComfyUI — MCP server + autonomous sidebar agent that drives your live graph in natural language on ANY LLM: Claude/ChatGPT/Gemini on your subscription (no API key), free local models via Ollama (fully offline),

---
description: Visualize a ComfyUI workflow as a mermaid diagram
argument-hint: Path to workflow JSON file, or paste JSON inline
---

# /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, in which case 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.)