GitHub Attach Images

Attach images to GitHub PRs or issues by hosting them in a scratch repo.

When to use

• Adding screenshots to PR comments
• Attaching images to issue comments
• Any GitHub comment needing embedded images

Setup scratch repo

1. Clone or create scratch repo

   git clone git@github.com:<USERNAME>/scratch.git /tmp/scratch
   

   If it doesn't exist, create a public repo called scratch first.

2. Folder structure

   scratch/
   └── github-attachments/
       └── <org>_<repo>_<pr-or-issue>/
           ├── 01-screenshot.png
           └── 02-screenshot.png
   

Add images

1. Copy images to scratch repo

   mkdir -p /tmp/scratch/github-attachments/<org>_<repo>_<number>
   cp /path/to/screenshots/*.png /tmp/scratch/github-attachments/<org>_<repo>_<number>/
   

2. Push to GitHub

   cd /tmp/scratch
   git add .
   git commit -m "chore: images for <org>/<repo>#<number>"
   git push
   

Attach to PR or issue

Comment on PR:

gh pr comment <NUMBER> --repo <org>/<repo> --body "$(cat <<'EOF'
## Screenshots

![Description of screenshot](https://raw.githubusercontent.com/<USERNAME>/scratch/main/github-attachments/<org>_<repo>_<number>/01-screenshot.png)

This shows...
EOF
)"

Comment on issue:

gh issue comment <NUMBER> --repo <org>/<repo> --body "$(cat <<'EOF'
![Description](https://raw.githubusercontent.com/<USERNAME>/scratch/main/github-attachments/<org>_<repo>_<number>/image.png)
EOF
)"

Image URL format

https://raw.githubusercontent.com/<USERNAME>/scratch/main/github-attachments/<org>_<repo>_<number>/<filename>