GitHub CLI Releases, Gists, and API

gh release list

# List releases for a repository.

gh release view v1.2.3

# Show details for a release tag.

gh release create v1.2.3 dist/*.tgz --title "v1.2.3" --notes "Bug fixes and improvements"

# Create a release and upload assets.

gh release create v1.2.3 --generate-notes

# Generate release notes automatically.

gh release upload v1.2.3 ./dist/app-linux-amd64.tar.gz#linux-amd64

# Upload additional assets to a release.

gh release download v1.2.3 -D ./downloads

# Download assets for a release.

gh release edit v1.2.3 --title "v1.2.3 stable"

# Edit release metadata.

gh release delete-asset v1.2.3 app-linux-amd64.tar.gz --yes

# Delete a specific release asset.

gh release delete v1.2.3 --cleanup-tag --yes

# Delete a release and optionally its tag.

gh attestation verify ./dist/app-linux-amd64.tar.gz --repo my-org/my-repo

# Verify an artifact attestation against a repository.

gh gist list

# List your gists.

gh gist view abcd1234

# Show a gist.

gh gist create notes.md --public

# Create a public gist from a file.

printf "hello
" | gh gist create -f hello.txt

# Create a gist from standard input.

gh gist edit abcd1234 -d "Updated shell snippets"

# Edit a gist.

gh gist clone abcd1234

# Clone a gist locally.

gh gist rename abcd1234 old.txt new.txt

# Rename a file within a gist.

gh gist delete abcd1234 --yes

# Delete a gist.

gh api repos/{owner}/{repo}

# Call a GitHub REST API endpoint.

gh api repos/{owner}/{repo}/issues -f title="Bug report" -f body="Details..."

# Create resources through the REST API.

gh api repos/{owner}/{repo} -H "Accept: application/vnd.github+json"

# Call the API with explicit headers.

gh api graphql --input query.json

# Send request payload from a file.

gh api graphql -f query='query($owner:String!,$repo:String!){repository(owner:$owner,name:$repo){name defaultBranchRef{name}}}' -F owner=cli -F repo=cli

# Call the GraphQL API with variables.

gh api repos/{owner}/{repo} --method PATCH -f description="New description"

# Update resources with a non-GET method.

gh api orgs/{owner}/repos --paginate --slurp

# Combine paginated results into a single JSON array.

gh api repos/{owner}/{repo}/issues/comments/123456 --method DELETE

# Delete a resource through the REST API.