Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GCLI-GISTS(1)		     General Commands Manual		   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-de-
     tected 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  bot-
	     tom.

     -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. De-
	     fault: 30. Note that on users with many gists  fetching  all  gists
	     can  take a considerable amount of time and may result in rate lim-
	     iting 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  stan-
		     dard 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. As-
		     sume yes.

     get     Download a file from a Gist. There are no options to  this  subcom-
	     mand.

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 contribu-
     tors.

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.12.0			   30-May-2026			   GCLI-GISTS(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gcli-gists&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help