gh-attach

gh attach envia um arquivo para o endpoint interno de anexos de usuário do GitHub (não existe API pública) e imprime a URL, que o GitHub renderiza automaticamente (imagem/vídeo/arquivo) onde quer que seja colada. A URL herda a visibilidade do repositório, então uploads de repositórios privados permanecem privados.

Pré-requisitos

gh extension list | grep -q 'gh attach' || gh extension install sudosubin/gh-attach

Os uploads usam um cookie de sessão do navegador do GitHub, não o token gh. Por padrão, gh deve estar autenticado para que gh-attach possa selecionar a conta do navegador correspondente. Se a conta errada for selecionada, adicione --browser <name> --profile <name>. Para uso sem interface gráfica (headless), defina GH_ATTACH_SESSION_TOKEN para o valor puro do cookie user_session. Trate-o como uma credencial de conta completa.

Passos

1. Upload: Use um caminho absoluto entre aspas. -R é opcional dentro de um repositório. Para GHES, use -R host/owner/repo. O comando imprime a URL em uma linha. O GitHub a renderiza automaticamente (imagem/vídeo/arquivo), então use-a como está:

URL=$(gh attach "$FILE" -R <owner>/<repo>)

2. Incorporar (sempre --body-file -, por exemplo, gh pr comment/edit, gh issue comment/edit):

printf '## Screenshots\n\n%s\n' "$URL" | gh pr comment <pr> -R <owner>/<repo> --body-file -

3. Download: Especifique o destino explicitamente. Anexos privados usam o token ativo gh, com cookies do navegador como fallback de autorização:

gh attach download "$URL" -O "$FILE"

Observações

• Repositório privado: a URL renderiza apenas para visualizadores autorizados. Espera-se que uma busca anônima retorne 404 ou 403.
• Dimensionamento: incorpore <img width="800" src="$URL"> em vez da URL pura.
• GitHub Cloud e GHES decidem quais extensões de arquivo e tipos de conteúdo eles aceitam.