Skip to content

v1.11.0 — agent-first CLI

Choose a tag to compare

View all tags
@skishore23 skishore23 released this 22 Jun 01:11
· 219 commits to main since this release
v1.11.0
64c9883
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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
Assets 2
Loading