GH-GIST-EDIT(1)

💅 GH-GIST-EDIT(1) — the manual page, bestie edition

okay so. you know gh-gist-edit? that's the one. it's the GitHub CLI manual page for editing one of your gists, and yes we're gonna get into it. ✨

🌸 NAME 🌸

gh-gist-edit — edit one of your gists. literally just yours. your gists. nobody else's. 💖

🦋 SYNOPSIS 🦋

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

so you feed it either an <id> or a <url> (pick one, bestie, the braces are giving "choose your fighter"), optionally a <filename>, plus whatever [flags] you're feeling. 🎀

👑 OPTIONS 👑

okay here's the whole lineup, no gatekeeping:

• -a, --add <string> — adds a brand new file to the gist. new file, who dis. 🦋
• -d, --desc <string> — sets a new description for the gist. glow-up for the caption, basically.
• -f, --filename <string> — picks which file you wanna edit. like choosing your main character. ⭐
• -r, --remove <string> — removes a file from the gist. it's giving "we don't know her." 💀

🔥 EXIT CODES 🔥

the vibe check results, in number form:

• 0 — Successful execution. slay. ✨
• 1 — Error. 😭
• 2 — Command canceled. you backed out, no judgment.
• 4 — Authentication required. log in first, bestie. 🙈

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. (iykyk — always check the command's help, it's the receipts.)

🎀 EXAMPLE 🎀

the examples ate, honestly. here they are exactly as they come:

# 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

notice the no-args one just opens an interactive picker? main character energy fr fr. and yeah, the "replace a file" one passes hello.py twice — once as the --filename and once as the local file. not a typo, that's just how it eats. 🍓

🌈 SEE ALSO 🌈

• gh-gist(1) — the parent page, go say hi. 🫶

---

and that's the whole page!! brought to you by GitHub CLI v2.102.0, Oct 2026 edition — mwah, go edit some gists, you got this 💜🧚🌸