comfyui-cli

Use the official comfy-cli safely for ComfyUI workspace discovery, setup, launch and stop, structured JSON automation, workflow execution including UI-format conversion, jobs, uploads, downloads, node

SKILL.md

GitHub

comfy-cli

Read

  • ../../references/COMFYUI_CLI.md
  • ../../references/COMFYUI_SECURITY.md

Procedure

  1. Detect comfy from COMFY_BIN or PATH. Do not guess a personal binary path.
  2. Ask the installed CLI for help when command syntax is uncertain.
  3. Prefer --json for machine-readable automation.
  4. Resolve the target workspace with comfy which or the user's explicit workspace option.
  5. Use background launch for an agent-controlled server lifecycle.
  6. Probe ComfyUI after launch.
  7. Use comfy-cli's run path when a UI-format workflow needs its supported conversion.
  8. Keep the prompt ID and use jobs/download for long runs.

Bundled bridge:

python scripts/comfyui_cli_bridge.py info
python scripts/comfyui_cli_bridge.py launch
python scripts/comfyui_cli_bridge.py stop
python scripts/comfyui_cli_bridge.py run --workflow WORKFLOW.json

The bridge is intentionally narrow. For commands not wrapped there, inspect the installed CLI help and call comfy directly.

Mutating dependencies

Custom node installs, broad updates, version switching, and model downloads change the execution environment. Require user intent, then restart and revalidate as appropriate.

Cloud

Do not add --where cloud as an automatic fallback. Cloud and partner operations can spend credits.

Live dependency operations

Use the bridge's read-only model and package discovery before changing the environment:

python scripts/comfyui_cli_bridge.py models-search --text MODEL
python scripts/comfyui_cli_bridge.py node-deps PACK
python scripts/comfyui_cli_bridge.py deps-in-workflow --workflow WORKFLOW.json --out DEPS.json

For an approved custom-node or model change, use the guarded bridge command. Never add --confirm merely because a command refused to proceed. The user must already have approved that exact environment change.

After a custom-node install, update, reinstall, repair, or dependency installation, restart ComfyUI and run live workflow validation again.