gh-gist-edit(1)

GH-GIST-EDIT(1) GitHub CLI manual GH-GIST-EDIT(1)

NAME

gh-gist-edit - Edit one of your gists

SYNOPSIS

gh gist edit {<id> | <url>} [<filename>] [flags]

OPTIONS

-a, --add <string>
Add a new file to the gist

-d, --desc <string>
New description for the gist

-f, --filename <string>
Select a file to edit

-r, --remove <string>
Remove a file from the gist

EXIT CODES

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

EXAMPLE

# Select a gist to edit interactively
$ gh gist edit
# Edit a gist file in the default editor
$ gh gist edit 1234567890abcdef1234567890abcdef
# Edit a specific file in the gist
$ gh gist edit 1234567890abcdef1234567890abcdef --filename hello.py
# Replace a gist file with content from a local file
$ gh gist edit 1234567890abcdef1234567890abcdef --filename hello.py hello.py
# Add a new file to the gist
$ gh gist edit 1234567890abcdef1234567890abcdef --add newfile.py
# Change the description of the gist
$ gh gist edit 1234567890abcdef1234567890abcdef --desc "new description"
# Remove a file from the gist
$ gh gist edit 1234567890abcdef1234567890abcdef --remove hello.py

SEE ALSO

gh-gist(1)

Jul 2026 GitHub CLI v2.96.0