---
name: "gh-gist-edit"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-gist-edit"
---

# gh-gist-edit(1)

Edit one of your gists

## 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)](/gh-gist/1.md)**