功能描述

Install, manage, and run ComfyUI instances. Use when setting up ComfyUI, launching servers, installing/updating/debugging custom nodes, downloading models from CivitAI/HuggingFace, managing workspaces, running API workflows, or troubleshooting node conflicts with bisect.

使用说明 (SKILL.md)

comfy-cli

Name: Comfy Cli
Author: johntheyoung

CLI tool for managing ComfyUI installations, custom nodes, and models.

Quick start

comfy install                          # Install ComfyUI + ComfyUI-Manager
comfy launch                           # Start ComfyUI server
comfy node install ComfyUI-Impact-Pack # Install a custom node
comfy model download --url "https://civitai.com/api/download/models/12345"

Installation

comfy install                          # Interactive GPU selection
comfy install --nvidia                 # NVIDIA GPU
comfy install --amd                    # AMD GPU (Linux ROCm)
comfy install --m-series               # Apple Silicon
comfy install --cpu                    # CPU only
comfy install --restore                # Restore deps for existing install
comfy install --pr 1234                # Install specific PR
comfy install --version latest         # Latest stable release
comfy install --version 0.2.0          # Specific version

GPU options: --nvidia, --amd, --intel-arc, --m-series, --cpu

CUDA versions (NVIDIA): --cuda 12.9, --cuda 12.6, --cuda 12.4, --cuda 12.1, --cuda 11.8

Other flags: --skip-manager, --skip-torch-or-directml, --skip-requirement, --fast-deps

Launch

comfy launch                           # Foreground mode
comfy launch --background              # Background mode
comfy launch -- --listen 0.0.0.0       # Pass args to ComfyUI
comfy stop                             # Stop background instance
comfy launch --frontend-pr 1234        # Test frontend PR

Workspace selection

Global flags (mutually exclusive):

comfy --workspace /path/to/ComfyUI ... # Explicit path
comfy --recent ...                     # Last used instance
comfy --here ...                       # Current directory
comfy which                            # Show selected instance
comfy set-default /path/to/ComfyUI     # Set default

Custom nodes

comfy node show                        # List installed nodes
comfy node simple-show                 # Compact list
comfy node install \x3Cname>              # Install from registry
comfy node install \x3Cname> --fast-deps  # Fast dependency install
comfy node reinstall \x3Cname>            # Reinstall node
comfy node uninstall \x3Cname>            # Remove node
comfy node update all                  # Update all nodes
comfy node disable \x3Cname>              # Disable node
comfy node enable \x3Cname>               # Enable node
comfy node fix \x3Cname>                  # Fix node dependencies

Snapshots:

comfy node save-snapshot               # Save current state
comfy node save-snapshot --output snapshot.json
comfy node restore-snapshot snapshot.json
comfy node restore-dependencies        # Restore deps from nodes

Debugging:

comfy node bisect                      # Binary search for broken node
comfy node deps-in-workflow workflow.json  # Extract deps from workflow
comfy node install-deps --workflow workflow.json  # Install workflow deps

Publishing:

comfy node init                        # Init scaffolding
comfy node scaffold                    # Create project via cookiecutter
comfy node validate                    # Validate before publishing
comfy node pack                        # Package node
comfy node publish                     # Publish to registry

Models

comfy model list                       # List available models
comfy model download --url \x3Curl>       # Download from URL
comfy model remove \x3Cname>              # Remove model

Sources: CivitAI, Hugging Face, direct URLs

Tokens for gated models:

--civitai-token or config civitai_api_token
--hf-token or config hf_api_token

Run workflows

comfy run --workflow workflow_api.json
comfy run --workflow workflow.json --wait --verbose
comfy run --workflow workflow.json --host 192.168.1.10 --port 8188

Requires running ComfyUI instance.

ComfyUI-Manager

comfy manager disable-gui              # Hide manager in UI
comfy manager enable-gui               # Show manager in UI
comfy manager clear                    # Clear startup actions

Update

comfy update all                       # Update ComfyUI + nodes
comfy update comfy                     # Update ComfyUI only

Other commands

comfy env                              # Show config and paths
comfy --version                        # Print CLI version
comfy pr-cache list                    # List cached PR builds
comfy pr-cache clean                   # Clear expired caches
comfy standalone                       # Create standalone Python bundle
comfy tracking enable|disable          # Manage analytics
comfy feedback                         # Submit feedback

Config

Location:

Linux: ~/.config/comfy-cli/config.ini
macOS: ~/Library/Application Support/comfy-cli/config.ini
Windows: %APPDATA%\Local\comfy-cli\config.ini

Keys: default_workspace, default_launch_extras, civitai_api_token, hf_api_token

Tips

--skip-prompt for non-interactive mode (CI/scripts)
Background mode tracks PID for clean comfy stop
Snapshots preserve exact node versions for reproducibility
comfy node bisect binary-searches to find which node broke your setup
PR cache avoids rebuilding frontend PRs you've tested before

安全使用建议

This skill appears to be a legitimate CLI for managing ComfyUI, but the package source is unknown in the registry metadata — there is no homepage or repository URL to inspect. Before installing: 1) Verify the 'comfy-cli' package origin (who publishes the 'uv' package and where its code is hosted). 2) Inspect the package contents or source (if available) to ensure it doesn't perform unexpected network calls or exfiltrate data. 3) Be cautious when supplying gated-model tokens (CivitAI/Hugging Face); these will be stored in the CLI's per-user config files (~/.config or %APPDATA%). 4) Expect network activity (downloading models, PR/front-end caches, feedback/analytics) and that the binary will run background processes and manage Python environments — run in a controlled environment or sandbox if you cannot verify the publisher. If you can obtain a homepage/repository or official release URL for the package, supply that and re-scan; with a verifiable source my confidence would increase.

功能分析

Type: OpenClaw Skill Name: comfy-cli Version: 1.0.0 The skill bundle describes a CLI tool (`comfy-cli`) with broad capabilities, including installing custom nodes (arbitrary Python code) from external sources, downloading models from arbitrary URLs, and handling sensitive API tokens (CivitAI, Hugging Face). While these capabilities are aligned with the stated purpose of managing ComfyUI, they represent high-risk operations that could lead to arbitrary code execution or data exposure if the tool were compromised or used with malicious inputs. There is no clear evidence of intentional malicious instructions for the agent within SKILL.md, but the inherent power of the described tool warrants a 'suspicious' classification.

能力评估

✓ Purpose & Capability

The name/description (manage ComfyUI, nodes, models, workflows) aligns with the declared binary ('comfy') and the SKILL.md commands. Mentioned features (model downloads, node management, bisect) reasonably explain needing a CLI and optional model tokens.

ℹ Instruction Scope

SKILL.md is an instruction-only manifest that stays inside the claimed domain: installing/launching ComfyUI, managing nodes/models, running workflows. It references storing civitai/hf tokens in its own config and running network operations (download models, feedback, analytics). It does not instruct reading unrelated system files or other credentials, but it does imply network activity and writing tokens to a config file.

⚠ Install Mechanism

The install spec uses an 'uv' package named 'comfy-cli' which will create the 'comfy' binary. No homepage or source URL is provided in the skill metadata, so it's not possible from this manifest to verify the origin or review the package contents before execution. That increases risk compared with a well-known release host (GitHub, PyPI, etc.).

ℹ Credentials

The skill does not require environment variables, which is appropriate. It documents optional civitai/hf tokens (flags or config keys) used only for gated model downloads; requesting those tokens would be proportional to the described functionality. Users should be aware tokens will be stored in the skill's config paths (user home locations listed).

✓ Persistence & Privilege

The skill is not always-enabled, does not request escalated platform privileges, and does not declare modifications to other skills or system-wide configs. It will create/modify its own config in standard per-user locations, which is normal for CLIs.

版本历史

v1.0.0

Initial release

元数据

Slug comfy-cli

版本 1.0.0

许可证 —

累计安装 10

当前安装数 10

历史版本数 1

常见问题

Comfy Cli 是什么？

Install, manage, and run ComfyUI instances. Use when setting up ComfyUI, launching servers, installing/updating/debugging custom nodes, downloading models from CivitAI/HuggingFace, managing workspaces, running API workflows, or troubleshooting node conflicts with bisect. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 3052 次。

如何安装 Comfy Cli？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install comfy-cli」即可一键安装，无需额外配置。

Comfy Cli 是免费的吗？

是的，Comfy Cli 完全免费（开源免费），可自由下载、安装和使用。

Comfy Cli 支持哪些平台？

Comfy Cli 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Comfy Cli？

由 johntheyoung（@johntheyoung）开发并维护，当前版本 v1.0.0。

Comfy Cli