NAME

gcli gists — manage GitHub Gists

SYNOPSIS

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.