GH-RELEASE-VERIFY(1)

πŸ’– GH-RELEASE-VERIFY(1) πŸ’–

bestie, welcome to the GitHub CLI manual β€” this is the page for gh-release-verify, and it's lowkey the vibe check for release attestations. Let's get into it ✨


🌸 NAME 🌸

gh-release-verify β€” verify the attestation for a release πŸ‘‘


πŸ¦‹ SYNOPSIS πŸ¦‹

gh release verify [<tag>] [flags]

✨ DESCRIPTION ✨

Okay so here's the deal: this command verifies that a GitHub Release is accompanied by a valid cryptographically signed attestation. No cap. πŸ”₯

An attestation is, literally, a claim made by GitHub regarding a release and its assets β€” it's giving receipts but make them cryptographic πŸ’…

This command checks that the specified release (or the latest release, if no tag is given) has a valid attestation. It fetches the attestation for the release and prints metadata about all assets referenced in the attestation, including their digests. Obsessed. πŸŽ€


πŸŽ€ OPTIONS πŸŽ€

  • --format <string> β€” output format. The one and only value here is {json} πŸ“
  • -q, --jq <expression> β€” filter the JSON output using a jq expression, iykyk 🧚
  • -t, --template <string> β€” format the JSON output using a Go template; peep gh help formatting for the deets 🌸

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • -R, --repo <[HOST/]OWNER/REPO> β€” select another repository using the [HOST/]OWNER/REPO format πŸ’œ

⭐ EXIT CODES ⭐

  • 0: Successful execution β€” slay πŸŽ‰
  • 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 πŸ¦‹

# Verify the latest release
gh release verify

# Verify a specific release by tag
gh release verify v1.2.3

# Verify a specific release by tag and output the attestation in JSON format
gh release verify v1.2.3 --format json

πŸ’œ SEE ALSO πŸ’œ


okay that's the whole page, you ate that πŸ’… this was the GitHub CLI manual, version v2.102.0, dated Oct 2026 β€” main character documentation energy from top to bottom, periodt 🌟

πŸ“¦ where this page comes from