GCLI-STATUS(1)

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

🌸 NAME 🌸

gcli status — ok so this is the one that lets you work with TODO lists 💖 and yes, it lives in section 1 of the manual, we're doing the <hotpink>gcli</hotpink> thing today bestie.

✨ SYNOPSIS ✨

gcli status
gcli status -l [-n number-of-items]
gcli status -m id

Like. That's it. Three moods. Pick one. 🎀

💅 DESCRIPTION 💅

So gcli status is your whole personality for dealing with TODO lists of forges. Forges! You know. The TODO list. The little pile of "hey you, look at me" ✨

Now here's the tea: when you run it with no subcommand arguments at all, gcli just slides into interactive mode 🦋 And interactive mode? Iconic. It lets you select TODO list items and operate on them — like running actions, or marking them as done, whatever your heart desires 💖

The actions are documented in the respective manual pages of the item types, iykyk. So if you, for example, select a TODO item that refers to an issue, then bestie you can invoke any action that's documented in gcli-issues(1) — straight from within the prompt. No cap. From inside the prompt. 🌈

And every other invocation? Non-interactive. Main character energy only in interactive mode, bestie 💅

🎀 OPTIONS 🎀

  • -n number-of-items — Fetch at most number-of-items items and print them. If you hand it a negative number it fetches all notifications instead (all of them!! 😭). The default is 30.
  • -l, --list — List TODO list items non-interactively. Very "just show me the list, I'm not in the mood for a conversation" of you 💅
  • -m, --mark id — Mark the TODO list item id as done. This will cause the item to not appear on the TODO list anymore. Poof. Gone. Slay. ✨

🌈 EXAMPLES 🌈

Print a TODO list for my-account:

$ gcli -a my-account status

Look through the TODO list, select a merge request, view changes, approve it, merge and mark as done — the full glow-up sequence 🦋:

$ gcli status
NUMBER  REPO     TYPE          REASON
1       foo/bar  Pull Request  mentioned
Enter number, list or quit: 1
Enter action, done or quit: status
   NUMBER : 381
    TITLE : Foo bar baz
     HEAD : author:bork
     BASE : target:master
  CREATED : 1970-Jan-1 00:00:00
   AUTHOR : author
    STATE : open
   MERGED : no
MERGEABLE : yes
    DRAFT : no
ASSIGNEES : someone
REVIEWERS : none
Enter action, done or quit: diff
Enter action, done or quit: approve -y
Enter action, done or quit: merge
Enter action, done or quit: done
Enter number, list or quit: l
NUMBER  REPO  TYPE  REASON
Enter number, list or quit: q

And one lil note, bestie: the diff is viewed in a pager 👀

🔥 SEE ALSO 🔥

👑 AUTHORS 👑

Nico Sonack aka. herrhotzenplotz <nsonack@herrhotzenplotz.de> and contributors 💜

💀 BUGS 💀

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 — and this is the important part, bestie, don't skip it 🙈 — the preferred and quickest method is to use the mailing list. Periodt. 💅

okay that's the whole page, love you, go mark something as done 🎀 — this was gcli version 2.13.0, dated 05-Aug-2026, brought to you by the manual for GCLI-STATUS(1) ✨💖🦋

📦 where this page comes from