1GH-GIST-CREATE(1)              GitHub CLI manual             GH-GIST-CREATE(1)
2
3
4

NAME

6       gh-gist-create - Create a new gist
7
8
9

SYNOPSIS

11       gh gist create [<filename>... | -] [flags]
12
13
14

DESCRIPTION

16       Create a new GitHub gist with given contents.
17
18
19       Gists  can  be  created from one or multiple files. Alternatively, pass
20       "-" as file name to read from standard input.
21
22
23       By default, gists are secret; use '--public' to  make  publicly  listed
24       ones.
25
26
27

OPTIONS

29       -d, --desc <string>
30              A description for this gist
31
32
33       -f, --filename <string>
34              Provide a filename to be used when reading from standard input
35
36
37       -p, --public
38              List the gist publicly (default: secret)
39
40
41       -w, --web
42              Open the web browser with created gist
43
44
45

EXAMPLE

47       # publish file 'hello.py' as a public gist
48       $ gh gist create --public hello.py
49
50       # create a gist with a description
51       $ gh gist create hello.py -d "my Hello-World program in Python"
52
53       # create a gist containing several files
54       $ gh gist create hello.py world.py cool.txt
55
56       # read from standard input to create a gist
57       $ gh gist create -
58
59       # create a gist from output piped from another command
60       $ cat cool.txt | gh gist create
61
62
63
64
65

SEE ALSO

67       gh-gist(1)
68
69
70
71                                   Nov 2023                  GH-GIST-CREATE(1)