GH-GPG-KEY(1)

πŸ’… NAME πŸ’…

gh-gpg-key β€” the vibe check for your GPG keys, bestie πŸ”‘

Okay so real talk, this is one of those command groups β€” it's the umbrella, the main character, the parent of three little subcommands that do the actual work. Keep reading, it all makes sense in a sec 🫢


✨ SYNOPSIS ✨

gh gpg-key <command> [flags]

That's it. That's the whole shape of it β€” you say gh gpg-key, then you name which <command> you want, then you toss on whatever [flags] you're feeling πŸ’…


🌸 DESCRIPTION 🌸

Manage GPG keys registered with your GitHub account.

Like β€” GPG keys are those cryptographic signing keys you use so GitHub can prove a commit or a tag actually came from you and not from some random imposter. This command group is your little control panel for the ones you've got hooked up to your account. Add 'em, delete 'em, list 'em. Very demure, very mindful πŸŽ€


πŸ¦‹ AVAILABLE COMMANDS πŸ¦‹

Girl, this is the menu. Pick your fighter πŸ₯Š

  • gh-gpg-key-add(1) β€” Add a GPG key to your GitHub account ✨ like, you're introducing a new key to your profile. So exciting.
  • gh-gpg-key-delete(1) β€” Delete a GPG key from your GitHub account πŸ’€ breaking up with a key. It happens.
  • gh-gpg-key-list(1) β€” Lists GPG keys in your GitHub account πŸ“‹ the "who's even on my account rn" check. Do this often, iykyk.
Not me reminding you that each of these has its own help page β€” if you wanna know the flags for one specific command, go read that one, bestie. This page is just the group chat, not the individual DMs πŸ™ˆ

πŸ”₯ EXIT CODES πŸ”₯

Every command tells you how it went down when it exits. Here's the legend, no cap:

  • 0 β€” Successful execution πŸŽ‰ ate and left no crumbs
  • 1 β€” Error 😭 something went wrong
  • 2 β€” Command canceled πŸ™ˆ you (or something) backed out before it finished
  • 4 β€” Authentication required πŸ” like, GitHub needs to know it's really you first
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. ✨ So don't come for this page if you see a number that's not on the list β€” check the individual command's --help and it'll fill you in, fr fr.

🌈 SEE ALSO 🌈

  • gh(1) β€” the big parent CLI itself πŸ‘‘ if you don't know her yet, start there

Go forth and sign your commits, icon. Your GPG keys are gonna look so good on your profile πŸ’–πŸ§š

✿ GitHub CLI v2.102.0 ✿ Oct 2026 ✿ mwah, thanks for reading, ily ✿

πŸ“¦ where this page comes from