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.  Without a subcommand specified,
       gcli gists will list Gists of the given or auto-detected user account.

OPTIONS

       -l, --long
               Print a long list instead of a short table.

       -s, --sorted
               Reverse the output such that most recent items appear at the bottom.

       -u, --user owner
               List Gists of the given user.

       -n, --count n
               Fetch at least n gists. Setting n to -1 will fetch all gists. Default: 30.  Note  that  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.

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.

               -d, --description description
                       The description of the Gist to be created.

       delete  Delete a Gist. The following options can be specified:

               -y, --yes
                       Do not ask for confirmation before deleting the Gist. Assume yes.

       get     Download a file from a Gist. There are no options to this subcommand.

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)

AUTHORS

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

BUGS

       This subcommand only works on GitHub.  It  is  not  implemented  for  GitLab,  as  GitLab  snippets  work
       differently.

       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.

gcli 2.9.1                                         04-Oct-2025                                     GCLI-GISTS(1)