v1.11.1 — agent-first CLI

The first PyPI-published cut of the agent-first comfy-cli. (v1.11.0 was tagged but did not publish to PyPI due to a release-trigger mismatch — v1.11.1 is the first published release of this line; identical code.)

An agent (or a human) can build, validate, run, and review image/video/audio workflows on a local server or Comfy Cloud, entirely from the terminal — with a stable machine contract underneath. Fully additive and backward-compatible for interactive use.

✨ Highlights

• One machine contract. Every command emits the same versioned JSON envelope; every error carries a registered code + an actionable hint. Agents never parse prose. (--json, auto on non-TTY.)
• A compile model for workflows. Author typed fragments, wire them with YAML blueprints into one graph (comfy workflow compose); comfy workflow decompose is the inverse. Folders are source; the compiled JSON is a build artifact.
• Pre-flight validation (CQL). comfy validate checks a graph against the live server's object_info before you spend.
• Async-by-default execution with comfy jobs — incl. comfy jobs wait <id…> to block on a whole batch at once.
• Projects (project/1 layout, content-addressed assets push, run journal, --where routing).
• comfy preview — image → thumbnail, video → contact sheet, audio → waveform.
• Bundled skills (comfy skills) that teach agents to operate · build · debug · present.
• One-step onboarding — comfy setup wizard, surfaced from the welcome screen and a first-run nudge.
• Install robustness — install/update no longer assume the workspace interpreter ships pip.

⚠️ One compatibility note

Interactive (terminal) use is unchanged. The one behavior change: piped/redirected output now defaults to JSON (this is what makes agents work out-of-the-box). For the old text output, pass --no-json or set COMFY_OUTPUT=pretty.

📦 Upgrade

pip install -U comfy-cli
comfy setup