GitHub CLI, 이슈·PR·댓글에 이미지·영상 첨부 기능 정식 지원

GitHub 공식 변경 로그에 따르면 GitHub CLI는 v2.99.0부터 이슈, 풀 리퀘스트(PR), 댓글을 작성하거나 수정할 때 로컬 이미지와 영상을 함께 올릴 수 있는 --attach 옵션을 정식 지원한다. 이 기능은 모든 GitHub 요금제 이용자에게 제공된다.

--attach는 gh issue create·edit·comment와 gh pr create·edit·comment 명령에서 반복해 사용할 수 있다. 명령줄에서 마크다운 본문을 작성하면서 파일 경로를 함께 넘기면, 해당 파일을 업로드하고 본문 안에 인라인으로 연결한다. 이미 본문에 로컬 경로로 적은 이미지가 있으면 해당 경로를 업로드된 자산으로 바꾸되 대체 텍스트는 유지한다. 본문에서 참조하지 않은 첨부 파일은 끝부분에 추가된다.

지원 형식은 PNG, JPEG, GIF, WebP, SVG와 MP4, MOV, WebM이다. 파일 경로 뒤에 #을 붙여 대체 텍스트를 지정할 수 있으며, 생략하면 파일명이 사용된다. GitHub는 화면 오류나 렌더링 결과처럼 설명만으로 전달하기 어려운 내용을 이슈와 PR에 바로 남길 수 있다고 설명했다.

업로드는 gh auth login으로 받은 OAuth 토큰이나 기존 개인 액세스 토큰을 사용하며, 대상 저장소에 대한 쓰기 권한이 필요하다. 이미지와 GIF의 최대 크기는 10MB다. 영상은 무료 요금제에서 10MB, 유료 요금제에서 100MB까지 올릴 수 있다. 이번 기능은 GitHub Enterprise Server에서는 지원하지 않는다.

개발자가 브라우저를 열어 파일을 끌어 놓던 과정을 CLI 작업 흐름 안으로 가져온 변화다. 자동화 도구나 코딩 에이전트가 이슈와 PR에 결과 화면을 남기는 경우에도 활용할 수 있지만, 저장소 쓰기 권한과 첨부 파일의 민감 정보 포함 여부는 별도로 관리해야 한다.

출처: GitHub 공식 변경 로그 https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/