Upload images to GitHub Issue/PR comments and insert them with fixed width.

Works with both GitHub.com and GitHub Enterprise.

• gh CLI (authenticated)
• playwright-cli (browser/direct mode, not needed for --release mode)
• jq (direct mode only)

brew tap atani/tap  # first time only
brew install gh-attach

# First run: login to GitHub in browser
gh-attach --issue 1 --image ./test.png --headed

gh extension install atani/gh-attach

# Use as: gh attach
gh attach --issue 123 --image ./screenshot.png

1. Install dependencies:

# gh CLI (if not installed)
brew install gh
gh auth login

# playwright-cli
npm install -g @playwright/mcp

2. Add to PATH:

# Option A: Symlink
ln -s /path/to/gh-attach/bin/gh-attach /usr/local/bin/gh-attach

# Option B: Add to PATH
export PATH="/path/to/gh-attach/bin:$PATH"

Login to GitHub in the browser session:

gh-attach --issue 1 --image ./test.png --headed
# Browser opens → Login to GitHub → Session is saved for future use

gh-attach --issue 123 --image ./screenshot.png

gh-attach --issue 123 --image ./e2e.png --body "E2E test result:"

gh-attach --issue 123 \
  --image ./before.png \
  --image ./after.png \
  --body 'Before: <!-- gh-attach:IMAGE:1 -->
After: <!-- gh-attach:IMAGE:2 -->'

gh-attach --issue 123 --image ./screenshot.png --release

For hosts configured in ~/.config/gh-attach/config, direct mode is auto-enabled. This uploads via the upload policies API + curl, producing user-attachments URLs without creating release artifacts.

# ~/.config/gh-attach/config
# direct_hosts=your-ghe-host.com

gh-attach --issue 123 --image ./screenshot.png --host your-ghe-host.com --repo owner/repo

Use --browser to override and force browser mode:

gh-attach --issue 123 --image ./screenshot.png --browser

gh-attach --issue 123 --image ./result.png --body-file report.md

Control where images are inserted in the comment body:

If no placeholder is present, images are appended to the end.

1. Create a comment with placeholder(s)
2. Open GitHub in browser via playwright-cli
3. Upload image(s) using GitHub's native upload UI
4. Extract the uploaded URL(s)
5. Update the comment with <img> tags

1. Create a comment with placeholder(s)
2. Upload image(s) to a GitHub Release via gh release upload
3. Update the comment with release download URLs

1. Create a comment with placeholder(s)
2. Open GitHub in browser via playwright-cli (for authentication)
3. Trigger the file-attachment component to obtain upload policies
4. Upload file(s) via curl to the media server
5. Update the comment with user-attachments URLs

Direct mode is auto-enabled for hosts listed in ~/.config/gh-attach/config:

direct_hosts=host1.example.com,host2.example.com

• PR comments use the same API as issue comments (use PR number)
• Images are inserted as HTML: <img src="..." width="800" alt="...">
• Browser session is persisted, so login is only needed once
• Use --headed to debug or when login is required