GCLI-GISTS(1)

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.