Reference

gcli-gists(1)

manage Github Gists

NAME

gcli gists – manage Github Gists

SYNOPSIS

gcli [-s] [-l] [-n n] [-u user]

gcli create [-d description] [-f path] gist-file-name

gcli delete [-y] gist-id

gcli get gist-id file-name

DESCRIPTION

Use gcli to list, create, download or delete Github Gists. Without a subcommand specified, gcli will list Gists of the given or autodetected 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 ⟨[email protected]⟩ 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 ~herrhotzenplotz/[email protected].

Alternatively you can report them on any of the forges linked at https://herrhotzenplotz.de/gcli. However, the preferred and quickest method is to use the mailing list.