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)

                                   Feb 2026                    GH-GIST-EDIT(1)