comfy-debug

When something fails on the comfy CLI, read the JSON envelope first, act on the hint, and only go deeper if needed. This skill is the bottom-up playbook.

The envelope is the source of truth

Every command emits the standard JSON envelope (see core skill). When error is present, map error.code to a fix below.

Three rules:

1. Map error.code to a fix below. Most codes have a one-line resolution.
2. hint is authoritative. If it says "run: comfy launch", that's the fix. Don't paraphrase, don't guess.
3. details carries the why. Look here before scrolling logs.

Decision tree for common failures