ConstantineB6/comfy-pilot

Talk to your ComfyUI workflows. Comfy Pilot gives Claude Code direct access to see, edit, and run your workflows — with an embedded terminal right inside ComfyUI.
Why?
Building ComfyUI workflows means manually searching for nodes, dragging connections, and tweaking values one at a time. With Comfy Pilot, you just describe what you want:
- *"Build me an SDXL workflow with ControlNet"* — Claude creates all the nodes, connects them, and sets the parameters
- *"Look at the output and increase the detail"* — Claude sees your generated image and adjusts the workflow
- *"Download the FLUX schnell model and set up a workflow for it"* — Claude downloads the model and builds a workflow from scratch
No copy-pasting node names. No hunting through menus. Just say what you want.
Installation
**CLI (Recommended):**
**ComfyUI Manager:**
1. Open ComfyUI
2. Click **Manager** → **Install Custom Nodes**
3. Search for "Comfy Pilot"
4. Click **Install**
5. Restart ComfyUI
**Git Clone:**
Claude Code CLI will be installed automatically if not found.
Requirements
- ComfyUI
- Python 3.8+
Features
- **MCP Server** - Gives Claude Code direct access to view, edit, and run your ComfyUI workflows
- **Embedded Terminal** - Full xterm.js terminal running Claude Code right inside ComfyUI
- **Image Viewing** - Claude can see outputs from Preview Image and Save Image nodes
- **Graph Editing** - Create, delete, move, and connect nodes programmatically
Demo
https://github.com/user-attachments/assets/325b1194-2334-48a1-94c3-86effd1fef02
Usage
1. Restart ComfyUI after installation
2. The floating Claude Code terminal appears in the top-right corner
3. The MCP server is automatically configured for Claude Code
4. Ask Claude to help with your workflow:
- "What nodes are in my current workflow?"
- "Add a KSampler node connected to my checkpoint loader"
- "Look at the preview image and tell me what you see"
- "Run the workflow up to node 5"
MCP Tools
The MCP server provides these tools to Claude Code:
| Tool | Description |
|------|-------------|
| get_workflow | Get the current workflow from the browser |
| summarize_workflow | Human-readable workflow summary |
| get_node_types | Search available node types with filtering |
| get_node_info | Get detailed info about a specific node type |
| get_status | Queue status, system stats, and execution history |
| run | Run workflow (optionally up to a specific node) or interrupt |
| edit_graph | Batch create, delete, move, connect, and configure nodes |
| view_image | View images from Preview Image / Save Image nodes |
| search_custom_nodes | Search ComfyUI Manager registry for custom nodes |
| install_custom_node | Install a custom node from the registry |
| uninstall_custom_node | Uninstall a custom node |
| update_custom_node | Update a custom node to latest version |
| download_model | Download models from Hugging Face, CivitAI, or direct URLs |