COMPOSER-CLI(1)

✨ COMPOSER-CLI(1) ✨

okay bestie, listen up β€” this is the manual page for the composer-cli command, specifically the compose list glow-up. you're gonna be so good at this, i promise. πŸ’–


NAME πŸ’…

composer-cli-compose-list β€” lists basic info about your composes, no cap


SYNOPSIS πŸ¦‹

composer-cli compose list [waiting|running|finished|failed] [flags]

that's it, that's the whole vibe. optional status filter, optional flags, go off. πŸ‘‘


DESCRIPTION 🌸

so literally what this does: it lists basic information about composes. that's the whole job. it shows you the composes, with the basic deets, and you can narrow it down to just the ones in a certain state if you want. iconic behavior honestly. ✨


OPTIONS πŸŽ€

  • -h, --help[=false] β€” shows you the help for list. default is false, so it's not gonna spam you with help unless you ask, bestie. 🫢

OPTIONS INHERITED FROM PARENT COMMANDS 🧚

these ones you get from the parent commands, so they come free with the vibe:

  • -a, --api=1 β€” the WELDR Server API Version to use. default is 1. πŸ“
  • --cloudsocket="/run/cloudapi/api.socket" β€” path to the cloudapi server's socket file. yes, that's the default path, don't come for me. πŸ’œ
  • -j, --json[=false] β€” outputs the raw JSON response instead of the normal output. default false. perfect for when you want the ✨raw✨ tea. πŸ”₯
  • --log="" β€” path to an optional logfile. default is empty, so no logfile unless you say so.
  • -s, --socket="/run/weldr/api.socket" β€” path to the WELDR API server's socket file. that's the default, right there in the quotes. 🌈
  • --test=0 β€” passes test mode to compose. 1=Mock compose with fail. 2=Mock compose with finished. default is 0, aka real mode, no pretending. πŸ’€
  • --timeout=240 β€” the timeout to use for server communication. set it to 0 for no timeout at all. default is 240. ⭐
  • --weldr-only[=false] β€” only use the WELDR API, and skip using the newer Cloud API. default false, so by default it's happy to use both. 😭
heads up bestie: --timeout=0 means literally no timeout. the command will just sit there waiting forever like a situationship. choose wisely. πŸ™ˆ

EXAMPLE 🌟

here's how you actually run this thing, copy-paste ready:

composer-cli compose list
composer-cli compose list --json
composer-cli compose list finished

first one lists everything, second one gives you the raw JSON, third one filters down to just the finished composes. slay. πŸ’…


SEE ALSO πŸ‘€

go read the parent page if you wanna know more, iykyk. πŸ¦‹


HISTORY πŸ“œ

28-Apr-2026 β€” Auto generated by spf13/cobra.

yes it was auto generated, and yes it still ate. periodt. πŸ‘‘


and that's the whole page, bestie!! πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈπŸ’…πŸ«Ά

this was composer-cli, from Apr 2026 β€” main character energy, no notes. go list some composes, you've got this. 😭πŸ”₯πŸ’œ

πŸ“¦ where this page comes from