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

v1.11.0 — agent-first CLI

This release turns comfy-cli into an agent-first tool: 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. Everything is additive and backward-compatible for interactive use; your existing commands and scripts keep working (see the one compatibility note below).

✨ Highlights

• One machine contract. Every command emits the same versioned JSON envelope, and every error carries a registered code + an actionable hint — an error is a navigation signal toward the fix, not just a failure. Agents never parse prose. (--json, auto on non-TTY.)
• A compile model for workflows. Author small typed fragments and wire them with YAML blueprints into one graph (comfy workflow compose); comfy workflow decompose is the inverse — it projects any workflow back into editable fragment source. 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 — combo types preserved, enum rejections carry the full untruncated options list.
• Async-by-default execution. Submit returns immediately, a detached watcher tracks the job, and later processes resume from a state file. New: comfy jobs wait <id…> blocks on a whole batch at once (summary envelope, per-job settled events, --all / --timeout).
• Projects. A project/1 layout with content-addressed assets push, a run journal, and --where routing (OAuth-first credentials).
• comfy preview — render any media to something viewable: image → thumbnail, video → contact sheet, audio → waveform.
• Bundled skills (comfy skills) that teach agents to operate · build · debug · present the CLI.
• One-step onboarding. comfy setup — a guided wizard (routing → sign-in → skills → verify). New users are now pointed at it from the welcome screen and a first-run nudge.
• Install robustness. comfy install / comfy update no longer assume the workspace interpreter ships pip (a pip-less uv-managed venv is bootstrapped automatically).

⚠️ One compatibility note

Fully backward-compatible for interactive (terminal) use — same commands, same pretty output. The single behavior change: when output is piped or redirected (non-TTY), commands with structured output now default to JSON instead of text (this is what makes agents work out-of-the-box). If a script parses the old piped text, pass --no-json or set COMFY_OUTPUT=pretty.

📦 Upgrade

pip install -U comfy-cli
comfy setup   # new here? this gets you from zero to running

v1.10.5

What's Changed

• Add Comfy-Usage-Source header to ComfyUI and cloud API requests by @robinjhuang in #468
• feat(node): add changelog support to comfy node publish by @bigcat88 in #469
• fix: broaden telemetry kwarg redaction and _ctx filter atomically (BE-992) by @mattmillerai in #459

New Contributors

• @mattmillerai made their first contribution in #459

Full Changelog: v1.10.4...v1.10.5

v1.10.4

What's Changed

• Add unreviewed-merge detector (SOC 2 compliance) by @luke-mino-altherr in #464
• feat(tracking): namespace PostHog events with cli: prefix by @robinjhuang in #465

New Contributors

• @luke-mino-altherr made their first contribution in #464

Full Changelog: v1.10.3...v1.10.4

v1.10.3

What's Changed

• feat(tracking): honor DO_NOT_TRACK and COMFY_NO_TELEMETRY env vars by @bigcat88 in #463

Full Changelog: v1.10.2...v1.10.3

v1.10.2

What's Changed

• feat(run): add --json NDJSON output mode for agents by @bigcat88 in #455
• feat(tracking): PostHog dual-send + canonical lifecycle events by @bigcat88 in #461

Full Changelog: v1.10.1...v1.10.2

v1.10.1

What's Changed

• fix(generate): include bundled openapi.yml in package by @robinjhuang in #458

Full Changelog: v1.10.0...v1.10.1

v1.10.0

What's Changed

• feat(generate): add nano-banana (Gemini) and Seedance by @robinjhuang in #457

Full Changelog: v1.9.0...v1.10.0

v1.9.0

What's Changed

• feat(generate): add comfy generate for direct partner model calls by @robinjhuang in #452
• feat(generate): reference-asset upload + long polling models (video) by @robinjhuang in #453
• chore(generate): rename X-Comfy-Env header to Comfy-Env by @robinjhuang in #456

Full Changelog: v1.8.0...v1.9.0

v1.8.0

What's Changed

• feat(registry): resolve PEP 621 dynamic version from [tool.comfy.version].path by @bigcat88 in #438
• feat(code-search): embed OSC 8 hyperlinks, filter to file matches by @snomiao in #426
• fix: resolve --version latest from local git tags before GitHub API by @bigcat88 in #441
• feat(run): auto-convert UI-format workflows via server endpoint by @bigcat88 in #448
• feat(run): convert UI workflows to API format client-side via /object_info by @bigcat88 in #450
• feat(run): add --api-key / COMFY_API_KEY for API Nodes by @bigcat88 in #451

Full Changelog: v1.7.3...v1.8.0