CLI for using ComfyUI
comfy-cli is a command-line tool for installing, running, and extending ComfyUI, an open-source engine that executes workflows for generating media. It is for people who manage ComfyUI installations, models, custom nodes, and workflows locally or through Comfy Cloud. The catalogue entries provide skills and instructions for operating ComfyUI through the command line and coding agents.
This repository also configures its own agents. See what comfy-cli tells them →
Skill Claude CodeCodex
Build a custom ComfyUI environment on the Comfy developer platform with comfy-cli: turn a local install, a ComfyUI Desktop snapshot, a workflow JSON, or nothing but a Dockerfile, a Modal script or a sentence into a committed comfy-build.yaml and a green release. Use whenever the user wants to package, build, pin, or…
Skill Claude CodeCodex
Debugging skill for the comfy CLI — failed workflows, stuck jobs, error envelopes, and the fastest path from "it broke" to "fixed".
Skill Claude CodeCodex
Use when asked to make a narrative video — an ad, brand film, short, trailer, music video, or any multi-shot clip that tells a story (not a single shot or loop). Also use when a video was rejected for "no story", "doesn't flow", "feels like a montage", or characters that change between shots.
Skill Claude CodeCodex
How to present and interact during comfy creative work (images, video, audio) — show visual previews in chat, not text about files. Creative media work is iterative and visual; it is NOT like code. Use whenever generating, reviewing, or iterating on media with the comfy CLI.
Skill Claude CodeCodex
Generate images, videos, audio, and 3D via ComfyUI — CLI surface, workflow creation hierarchy (template → fragment → raw JSON), domain gotchas, cloud auth, multi-stage orchestration.
Skill Claude CodeCodex
Reference skill cited by comfy-build. Read it with comfy skills show comfy-build-authoring when authoring a comfy-build.yaml definition by hand — the user has no ComfyUI install to scan, or you are editing a spec's models and customNodes directly. Covers searching the node registry, resolving model filenames to public…
Skill Claude CodeCodex
Reference skill cited by comfy-build. Read it with comfy skills show comfy-build-failures when a build failed, a push or release was refused, or an importer printed advisories you need to interpret. Covers every advisory key a scan, snapshot or workflow import emits, how to read failureReason and release logs, the…
Skill Claude CodeCodex
Reference skill cited by comfy-build. Read it with comfy skills show comfy-build-pins when deciding what belongs in a comfy-build.yaml's pipDependencies, or when a build failed on a dependency conflict. Covers which pins to delete and which to keep, the package pairs that must move together, and how to predict a…
Skill Claude CodeCodex
Reference skill cited by comfy-deploy. Read it with comfy skills show comfy-deploy-failures when a deploy command was refused, a deployment will not reach ready, a job failed, or a deployment is stuck in stopfailed. Maps every deploy error code to what it means and the move that clears it, and covers reading a…
Skill Claude CodeCodex
Run a Comfy Build release as a serverless deployment with comfy-cli. Use whenever the user wants to deploy, serve, host, or expose a ComfyUI build as an endpoint, scale or stop workers, submit a workflow to a deployment, check whether a deployment is healthy or running a stale release, or work out why one is still…
Skill Claude CodeCodex
Use when a permission blocks the local comfy agent — a folder it cannot read or write, a host a download was refused for, a shell it does not have — to know what the agent may reach by default, how a request is recorded (requestpath, requesthost) and how only the user approves it (comfy agent allow --approve, a panel…
Skill Claude CodeCodex
Use when a user asks to write, fix, review, validate, package, or troubleshoot ComfyUI custom-node code, including V1 or V3 nodes and integrations.
Skill Claude CodeCodex
Packaged fallback for ComfyUI V3 and legacy V1 custom-node schema shape.
Skill Claude CodeCodex
Packaged fallback for dependency, capability, and local-versus-Cloud custom-node constraints.
Skill Claude CodeCodex
Packaged fallback for shipping browser-side assets from a custom-node pack.
Skill Claude CodeCodex
Packaged fallback for deciding whether and how to enter custom-node authoring.
Skill Claude CodeCodex
Packaged fallback for migrating a custom-node pack from V1 to V3 registration.
Skill Claude CodeCodex
Packaged fallback for custom-node registry metadata, validation, and publishing.
Skill Claude CodeCodex
Packaged fallback for deciding when ecosystem code search is required, optional, or wasteful.
Skill Claude CodeCodex
Packaged fallback for stage-specific custom-node troubleshooting.
Skill Claude CodeCodex
Packaged fallback for staged validation of generated custom-node code.
At most 3 mods per repository are shown here, and a mod shipped inside a plugin is left to that plugin's page — the rest are on their repository pages: