Tooluck logoTooluck
SKILL.md

comfyui-launch-flags

Agent skill fromartokun/comfyui-mcp

Pick the right ComfyUI startup flags for VRAM, attention, caching, and speed. The full decision matrix for OOM (--novram / --cache-none / --disable-smart-memory), shared-VRAM creep on Windows (--reserve-vram N), model-switching with big text encoders (--cache-none), high-VRAM throughput (--gpu-only / --highvram), and attention-backend selection (--use-sage-attention for speed, --use-pytorch-cross-attention as the highest-quality / Z-Image-safe fallback). Also the acceleration-stack + Blackwell/RTX 5000 (sm_120) notes. Use when a graph OOMs (especially long video like LTX 2 / WAN), when the GPU spills into shared VRAM and slows to a crawl, when switching between models eats all RAM, when Z-Image produces black/garbled output under Sage, or when deciding which attention backend to launch with. Flag names verified against upstream comfy/cli_args.py; see Sources.

How to install comfyui-launch-flags

install comfyui-launch-flags
# install the comfyui-mcp pack with the skills CLI
npx skills add artokun/comfyui-mcp

# or add only this skill to Claude Code: copy the folder

plugin/skills/comfyui-launch-flags/

# into

~/.claude/skills/comfyui-launch-flags/ (all projects)

.claude/skills/comfyui-launch-flags/ (one project)

plugin/skills/comfyui-launch-flags/SKILL.md

MITFull file
1# ComfyUI launch/performance flags
2
3## Overview
4
5CLI flags passed to `main.py` control ComfyUI's runtime behavior
6(e.g. `python main.py --reserve-vram 2 --use-sage-attention`). The three that
7matter most for making a graph *run* rather than OOM or crawl are the
8VRAM strategy, the attention backend, and the cache mode. This skill
9is the decision matrix for choosing them.
10
11> ⚠️ **Verification note (August 2026).** Every flag below was checked against
12> upstream [`comfy/cli_args.py`](https://github.com/comfyanonymous/ComfyUI/blob/master/comfy/cli_args.py)
13> on current master. ComfyUI adds/renames flags often — when in doubt run
14> `python main.py --help` in the target install and prefer that over this list.
15> **`--enable-triton-backend` / `--disable-triton-backend` ARE ComfyUI `main.py`
16> flags on master** (they used to be documented as SwarmUI-only; that is stale).
17> `--use-ck-attention` is kitchen INT8 attention — no `sageattention` wheel.
18> A June ComfyUI checkout still pins comfy-kitchen 0.2.10 and lacks
19> `--use-ck-attention`; `kitchen` action:"status" reports ComfyUI-side flag
20> support, not only the kitchen version. Use `kitchen` / `panel_kitchen` to see
21> what this GPU can actually run.
22
23> How to apply today. The MCP's `restart_comfyui` (with `action: "start"`)
24> currently *replays the exact argv of the previous run*. It does not compose
25> fresh flags. So set these when you launch ComfyUI yourself (the
26…

Excerpt shown under the repository's MIT license.

More skills in comfyui-mcp

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates