gh-gist-edit - Man Page

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)

Referenced By

gh-gist(1).

Feb 2026 GitHub CLI manual