COMPOSER-CLI(1)

COMPOSER-CLI(1) 💖 the composer-cli manual, bestie edition

okay so this is the manual page for composer-cli, and today we're specifically deep in our composer-cli-projects-list era ✨ grab a boba, we're doing this.

---

🌸 NAME 🌸

composer-cli-projects-list — List available projects 💅

that's it. that's the whole job. she lists projects and she does it gorgeously.

---

🎀 SYNOPSIS 🎀

composer-cli projects list [flags]

literally just that, no cap 🫶

---

🦋 DESCRIPTION 🦋

List available projects. iconic behaviour honestly. you run it, it shows you the projects. main character energy from start to finish 👑

---

✨ OPTIONS ✨

• --arch="" — Architecture. tell her which architecture you're curious about, default is empty (aka no filter, aka free spirit 🌈)
• --distro="" — Distribution. which distro you wanna peek at. also defaults to empty because she's chill like that
• -h, --help[=false] — help for list. the classic. she'll explain herself if you ask nicely 💖

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these ones didn't come from list, she inherited them from her parent command. generational wealth fr fr 💀✨

• -a, --api=1 — WELDR Server API Version to use. defaults to 1
• --cloudsocket="/run/cloudapi/api.socket" — Path to the cloudapi server's socket file. that's the default path, don't lose it 🎀
• -j, --json[=false] — Output the raw JSON response instead of the normal output. for when you want the ✨raw✨ data, no makeup, no filter, just JSON
• --log="" — Path to optional logfile. optional bestie, only if you want receipts
• -s, --socket="/run/weldr/api.socket" — Path to the WELDR API server's socket file. default path right there
• --test=0 — Pass test mode to compose. 1=Mock compose with fail. 2=Mock compose with finished. — so 1 = mock compose that fails 😭, 2 = mock compose that finishes 🌟, and 0 (the default) means you're not playing pretend at all
• --timeout=240 — Timeout to use for server communication. Set to 0 for no timeout. default is 240. set it to 0 and she'll wait forever, which is either devotion or a red flag, your call 🙈
• --weldr-only[=false] — Only use the WELDR API; skip using the newer Cloud API. for the purists who don't wanna touch the new stuff 💅

---

🌟 EXAMPLE 🌟

here's exactly how you'd run her, all four flavours, verbatim:

composer-cli projects list
composer-cli projects list --json
composer-cli projects list --distro fedora-38
composer-cli projects list --distro fedora-38 --arch aarch64

first one is the bare minimum slay, second one is the raw JSON serve, third is filtering by distro, fourth is filtering by distro and arch because you're thorough like that 🧚

---

💜 SEE ALSO 💜

• composer-cli-projects(1) — go read the parent, she's the whole vibe 💖

---

📜 HISTORY 📜

28-Apr-2026 — Auto generated by spf13/cobra 🐍 (yes bestie, a robot wrote this, and honestly? it ate)

---

and that's the page!! 🎀 this manual came from composer-cli, Apr 2026 version, and it was documented in the COMPOSER-CLI(1) manual. periodt. go list some projects, you got this 💅✨🦋