COMPOSER-CLI(1)

📦
version 36.2 · 6 versions
, in fedora 44

💖 COMPOSER-CLI 💖

okay bestie, welcome to the composer-cli manual, and specifically the ✨ blueprints diff ✨ page. we're in the COMPOSER-CLI(1) section of the manual, it's giving very much "I read the docs so you don't have to" energy, and honestly? obsessed.

🌸 NAME 🌸

composer-cli-blueprints-diff — list the differences between two blueprint commits. that's it, that's the job, no cap. 💅

✨ SYNOPSIS ✨

composer-cli blueprints diff BLUEPRINT FROM-COMMIT TO-COMMIT [-- DIFF-
ARG ...] [flags]

yes the DIFF-ARG really does wrap onto the next line like that, we don't make the rules, we just report them 🫶

🦋 DESCRIPTION 🦋

diff lists the differences between two blueprint commits, and it is literally the main character of this page:

  • FROM-COMMIT is a commit hash or NEWEST,
  • and TO-COMMIT is a commit hash, NEWEST, or WORKSPACE

Arguments passed after -- are passed directly to the system diff utility. so like, whatever chaos you want to hand off to diff, you can. we just hold the door open for you 🚪✨

🎀 OPTIONS 🎀

  • -h, --help[=false] — help for diff. your little "what does this even do" button. press it, no shame 💖

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these ones aren't technically diff's, they're inherited from the parent commands, but they still show up to the party so let's give them their moment:

  • -a, --api=1 — WELDR Server API Version to use.
  • --cloudsocket="/run/cloudapi/api.socket" — Path to the cloudapi server's socket file.
  • -j, --json[=false] — Output the raw JSON response instead of the normal output. for when you want the data raw, no filter, no vibes, just JSON 📦
  • --log="" — Path to optional logfile.
  • -s, --socket="/run/weldr/api.socket" — Path to the WELDR API server's socket file.
  • --test=0 — Pass test mode to compose. 1=Mock compose with fail. 2=Mock compose with finished.
  • --timeout=240 — Timeout to use for server communication. Set to 0 for no timeout. (yes, 0 means forever, choose wisely bestie 🕰️)
  • --weldr-only[=false] — Only use the WELDR API; skip using the newer Cloud API.

🔥 EXAMPLE 🔥

stealing these straight from the source, character for character, because they ate:

composer-cli blueprints diff simple HASH WORKSPACE
composer-cli blueprints diff simple HASH NEWEST -- -c --minimal

see that second one? that's the -- handoff in action, passing -c and --minimal straight through to diff. iconic behavior, honestly 🌈

🌟 SEE ALSO 🌟

📜 HISTORY 📜

  • 28-Apr-2026 — Auto generated by spf13/cobra
fr fr, a robot wrote this section. spf13/cobra said "I got it" and we respect that 🫡

and that's the whole page bestie!! this was composer-cli, from the Apr 2026 release, living in the COMPOSER-CLI(1) manual. go diff some blueprints, stay hydrated, and remember: NEWEST and WORKSPACE are your friends 💖✨🎀🦋🌸💅🫶

📦 where this page comes from