.TH "hub-gist" "1" "18 Oct 2023" "hub version 2.14.2" "hub manual"
.nh
.ad l
.SH "NAME"
hub\-gist \- Create and print GitHub Gists
.SH "SYNOPSIS"
.P
\fB\fChub gist\fR create [\-oc] [\-\-public] [\fIFILES\fP...]
.br
\fB\fChub gist\fR show \fIID\fP [\fIFILENAME\fP]
.SH "COMMANDS"
.PP
\fIcreate\fP
.RS 4
Create a new gist. If no \fIFILES\fP are specified, the content is read from
standard input.
.RE
.PP
\fIshow\fP
.RS 4
Print the contents of a gist. If the gist contains multiple files, the
operation will error out unless \fIFILENAME\fP is specified.
.RE
.br
.SH "OPTIONS"
.PP
\-\-public
.RS 4
Make the new gist public (default: false).
.RE
.PP
\-o, \-\-browse
.RS 4
Open the new gist in a web browser.
.RE
.PP
\-c, \-\-copy
.RS 4
Put the URL of the new gist to clipboard instead of printing it.
.RE
.br
.SH "EXAMPLES"
.PP
.RS 4
.nf
$ echo hello | hub gist create \-\-public

$ hub gist create file1.txt file2.txt

# print a specific file within a gist:
$ hub gist show ID testfile1.txt
.fi
.RE
.SH "SEE ALSO"
.P
hub(1), hub\-api(1)