GCLI-MILESTONES(1)

📦
version 2.13.0 · 5 versions
, in nixpkgs unstable, ubuntu stonking

💖 GCLI-MILESTONES — the manual page, but make it cute 💖

okay bestie, welcome to the General Commands Manual entry for gcli-milestones, part of gcli version 2.13.0. yes this is a real manpage and yes i'm about to make it slay. grab a boba, we're doing this 🧋✨

✨ NAME ✨

gcli milestones — list and manage milestones in various Git Forges. that's it. that's the whole vibe 🌸

🌈 SYNOPSIS 🌈

okay so here's the shape of it, copy-paste these exactly bestie:

gcli milestones [forge-path] [-o owner -r repo]
gcli milestones [forge-path] [-o owner -r repo] [-i id]
gcli milestones [forge-path] create [-o owner -r repo] -t title
                [-d description]

💅 DESCRIPTION 💅

the gcli milestones command is your girl for working with milestones on various git(1) forges. list them, create them, modify them, delete them. the whole lifecycle, no cap. 👑

🎀 OPTIONS 🎀

every single flag, right here, not skipping a single one because that's not the energy we bring:

  • -i, --id id — operate on a milestone with the given id. you're picking ONE milestone to mess with, this is how you point at it 👉
  • -o, --owner owner — work with milestones on a repository of the given owner. like, whose repo is it 💁
  • -r, --repo repo — work with milestones on the given repo. which repo specifically 🫶
  • -t, --title title — create a milestone with the given title. heads up: this option is mandatory when creating a milestone. no title, no milestone, periodt 💀
  • -d, --description description — create the milestone with the given description. the little extra flavor text, love that for you 📝

🦋 ACTIONS 🦋

when you're operating on a single milestone, you may use one or more of these actions (yes, more than one, mix and match, we stan flexibility ✨):

  • all — print both general status info and a list of issues related to the given milestone. the everything bagel of actions 🥯
  • status — print general metadata and information about the milestone. the ~vitals~ check 🩺
  • issues — print a list of issues attached to the milestone. the receipts of who's attached to what 🧾
  • delete — delete this milestone. gone. bye. 💀
  • open — open this milestone in a web browser. yeet it straight into your browser tab 🌐

🌟 EXAMPLES 🌟

real commands, real energy, use them exactly as written:

print a list of milestones for the current auto-detected forge:

$ gcli milestones

print details about the milestone with the ID 42:

$ gcli milestones -i 42 status

create a new milestone with the title foobar:

$ gcli milestones create -t foobar

delete milestone number 420 in vim/vim on GitHub:

$ gcli -t github milestones -i 420 delete

list milestones in herrhotzenplotz/gcli on GitHub using the forge path shorthand:

$ gcli milestones gh:herrhotzenplotz/gcli

that last one?? the shorthand?? it's giving efficiency. iykyk 💅

👀 SEE ALSO 👀

go read these too bestie, they're family:

🫶 AUTHORS 🫶

Nico Sonack aka. herrhotzenplotz <nsonack@herrhotzenplotz.de> and contributors. shoutout to the contributors, the unsung icons 🙌

🐛 BUGS 🐛

okay so there's one thing you need to know and i need you to hear me on this:

the delete subcommand deletes the milestone without asking for confirmation. like, no "are you sure?", no "really really sure?", just POOF. so be careful, bestie 😭

please report bugs via E-Mail to https://lists.sr.ht/~herrhotzenplotz/gcli-discuss.

alternatively you can report them on any of the forges linked at https://sr.ht/~herrhotzenplotz/gcli. however, the preferred and quickest method is to use the mailing list 📬

and that's the whole page!! this was gcli version 2.13.0, dated 05-Aug-2026, from the General Commands Manual. go forth and manage your milestones, you absolute main character 🌈👑💖

📦 where this page comes from