Scroll to navigation

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

Add a new file to the gist

New description for the gist

Select a file to edit

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)

Mar 2026 GitHub CLI v2.89.0