GCLI-GISTS(1)

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

💖 GCLI-GISTS — the girlies' guide to gcli gists 💖

okay so bestie, this is section 1 of the manual, and it's all about gcli gists — the command that manages your GitHub Gists. yes, the whole thing, listed, made, grabbed, deleted. let's get into it 🫶

✨ NAME ✨

gcli gists — manage GitHub Gists 💅

🎀 SYNOPSIS 🎀

gcli gists [-s] [-l] [-n n] [-u user]
gcli gists create [-d description] [-f path] gist-file-name
gcli gists delete [-y] gist-id
gcli gists get gist-id file-name

🦋 DESCRIPTION 🦋

Use gcli gists to list, create, download or delete GitHub Gists. that's the whole vibe, four jobs, one command, iconic.

Without a subcommand specified, gcli gists will list the Gists of the given — or auto-detected — user account. so if you just type it and hit enter, it's gonna snoop around and figure out whose gists you mean. lowkey smart of it fr fr.

🌸 OPTIONS 🌸

these are the top-level options, bestie, the ones for when you're just listing:

  • -l, --long — print a long list instead of a short table. more deets, more rows, more to look at 👀
  • -s, --sorted — reverse the output so the most recent items appear at the bottom instead of the top. yes, it flips it like that.
  • -u, --user owner — list the Gists belonging to the given user. you point, it fetches.
  • -n, --count n — fetch at least n gists. setting n to -1 will fetch all gists. default: 30.
⚠️ heads up bestie: on users with many gists, fetching all gists can take a considerable amount of time and may result in rate limiting by the GitHub API. so like… maybe don't just yolo -1 on a legend's account. 😭

👑 SUBCOMMANDS 👑

🌈 create 🌈

Paste a new Gist. the following flags can be specified:

  • -f, --file file — read the content from the specified file instead of standard input. no piping required, she takes a path 💅
  • -d, --description description — the description of the Gist to be created. give your gist a little blurb, a lil name tag.

🍓 delete 🍓

Delete a Gist. the following options can be specified:

  • -y, --yes — do not ask for confirmation before deleting the Gist. assume yes. this one is the "no take-backsies, just do it" flag. use it with care, bestie.

🧚 get 🧚

Download a file from a Gist. there are no options to this subcommand. it's just built different (simple). periodt.

⭐ EXAMPLES ⭐

List neutaaaaan's Gists:

$ gcli gists -u neutaaaaan

Paste a new gist named foobar and read from foobar.txt:

$ gcli gists create foobar < foobar.txt

Delete gist with id 3b546069d2856e6051bbe3c1080f1b5d:

$ gcli gists delete 3b546069d2856e6051bbe3c1080f1b5d

Print foobar.txt from Gist with id 3b546069d2856e6051bbe3c1080f1b5d into your pager:

$ gcli gists get 3b546069d2856e6051bbe3c1080f1b5d foobar.txt | $PAGER

🔥 SEE ALSO 🔥

git(1), gcli(1) — go read those too, they're the supporting cast 🫶

💜 AUTHORS 💜

Nico Sonack aka. herrhotzenplotz <nsonack@herrhotzenplotz.de> and contributors. absolute legends. main character energy, no cap. 👑

💀 BUGS 💀

This subcommand only works on GitHub. it is not implemented for GitLab, as GitLab snippets work differently. so like, don't come for it, it simply doesn't do that. 🙈

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. iykyk. ✨

🎀 and that's the whole page bestie!! this was gcli gists, from gcli 2.13.0, dated 05-Aug-2026. go forth and gist responsibly 💅💖✨
📦 where this page comes from