풀 리퀘스트

에이전트의 브랜치에서
리뷰를 마친 풀 리퀘스트까지

에이전트가 일을 마쳤습니다. 예전에는 GitHub로 가서 풀 리퀘스트를 열고, 돌아와서 리뷰를 읽고, 코멘트를 하나씩 에이전트의 터미널에 붙여 넣었습니다.

AgentsRoom은 이 단계들을 에이전트가 일하는 곳에서 처리합니다. 'PR 만들기'는 Changes 탭의 푸시 옆에 있습니다. AI가 제목과 설명의 초안을 쓰고 여러분이 수정하면, 그다음부터는 배지가 상태와 리뷰를 따라갑니다. 리뷰어가 코멘트를 남기면 클릭 한 번으로 해결되지 않은 코멘트가 에이전트에게 전달됩니다.

Changes

fix/checkout-total

푸시CI 통과#42 열림

변경 요청됨

해결되지 않은 코멘트 3개

코멘트를 에이전트에게 보내기

에이전트

풀 리퀘스트 #42, 브랜치 fix/checkout-total의 리뷰 코멘트:

  • cart.ts, 48번째 줄
  • total.test.ts, 12번째 줄

수정하고 같은 브랜치에 푸시하세요. 병합하지 마세요.

에이전트 CLI는 요청을 받고 GitHub CLI가 설치되어 있으면 스스로 풀 리퀘스트를 열 수 있습니다. 남는 것은 그 주변의 모든 일입니다. 브랜치가 푸시되었는지 확인하고, 리뷰어가 읽을 수 있는 설명을 쓰고, 리뷰가 오는지 지켜보고, 코드를 쓴 에이전트에게 코멘트를 다시 가져다주는 일입니다.

한 프로젝트에 에이전트가 여럿 있고 각자 자기 worktree에서 일한다면, 이 과정이 하루에도 몇 번씩 반복됩니다. 코멘트는 GitHub나 GitLab에 있고, 에이전트는 여러분의 터미널에 있으며, 그 사이에서 옮겨 적는 사람은 여러분입니다.

AgentsRoom은 풀 리퀘스트를 Changes 탭의 푸시와 CI 배지 옆에 둡니다. 리포지토리를 가져올 때 연결한 바로 그 계정을 사용합니다. 에이전트가 Claude Code, Codex, GitHub Copilot CLI, Cursor 또는 다른 어떤 CLI를 실행하든 똑같이 작동합니다.

제공 기능

여는 버튼 하나, 지켜보는 배지 하나, 고치게 하는 메시지 하나.

푸시 옆의 'PR 만들기'

Changes 탭, '워크트리' 보기의 각 행, 에이전트의 오른쪽 클릭 메뉴에 있습니다. 브랜치를 한 번도 푸시하지 않았다면 버튼이 '푸시하고 PR 만들기'로 바뀌어 두 가지를 모두 처리합니다.

제목과 설명의 초안을 대신 작성

AI가 브랜치 diff, 커밋, 연결된 티켓을 바탕으로 작성합니다. 여러분은 이를 수정하고, 기준 브랜치를 바꾸고, '초안으로 열기'를 체크한 뒤 보냅니다. 클릭하기 전에는 아무것도 보내지지 않습니다.

배지에 표시되는 상태와 리뷰

초안, 열림, 병합됨, 닫힘 상태와 리뷰 결과(승인됨, 변경 요청됨), 해결되지 않은 코멘트 수가 CI 배지 옆에 표시됩니다. 클릭하면 호스트에서 풀 리퀘스트가 열립니다.

리뷰 코멘트를 에이전트에게

'코멘트를 에이전트에게 보내기'는 해결되지 않은 스레드를 파일, 줄, 작성자, 코드 발췌와 함께 보여 줍니다. 에이전트가 건드리지 말아야 할 항목의 선택을 해제하면, 나머지가 메시지 하나로 전달됩니다.

리뷰가 도착하면 알림

AgentsRoom에서 만든 풀 리퀘스트에 리뷰나 코멘트가 달리면 데스크톱에 알림이 뜨고, 자리를 비웠을 때는 휴대폰으로도 받습니다.

휴대폰과 티켓에서도

모바일 앱의 '워크트리' 화면은 체크아웃마다 풀 리퀘스트를 보여 주고, 만들기와 코멘트 보내기도 할 수 있습니다. 실제 작업은 데스크톱이 합니다. 연결된 백로그 티켓에는 번호, 상태, 리뷰 결과가 표시됩니다.

작동 방식

호스트를 한 번 연결하면, 그다음 과정은 Changes 탭 안에서 이어집니다.

  1. 1

    GitHub 또는 GitLab을 한 번만 연결

    리포지토리를 가져올 때 연결한 계정을 쓰거나, 회색 PR 배지에서 연결합니다. GitHub에서는 repo 범위가 있는 클래식 토큰이나 Pull requests: write 권한이 있는 세분화된 권한의 토큰을 씁니다. GitLab에서는 머지 리퀘스트를 만들 수 있도록 api 범위가 있는 토큰을 씁니다.

  2. 2

    'PR 만들기' 클릭

    AI가 브랜치를 바탕으로 제목과 설명의 초안을 쓰는 동안 마스코트가 생각에 잠깁니다. 내용을 읽고 수정하고, 기준 브랜치를 확인하고(포크라면 upstream이 제안됩니다), 필요하면 '초안으로 열기'를 체크한 뒤 'PR 만들기'를 누릅니다.

  3. 3

    배지 따라가기

    CI 배지 옆의 배지가 상태, 리뷰 결과, 해결되지 않은 코멘트를 보여 줍니다. 자기 worktree에서 일하는 에이전트의 카드와 연결된 티켓에도 표시됩니다.

  4. 4

    코멘트를 에이전트에게 보내기

    코멘트 수를 클릭하고, 그대로 둘 항목의 선택을 해제하고, 그 체크아웃의 에이전트나 그 안에서 시작할 새 에이전트를 골라 보냅니다. 에이전트가 수정하고 커밋한 뒤 같은 브랜치에 푸시하면 풀 리퀘스트도 업데이트됩니다.

에이전트가 여럿일 때 이것이 중요한 이유

에이전트 하나가 일주일에 풀 리퀘스트 하나를 연다면 손으로 해도 부담이 없습니다. 에이전트 네 개가 같은 날 오후에 브랜치를 마치면, 느린 부분은 더 이상 코드가 아닙니다. 풀 리퀘스트를 하나씩 열고, 리뷰할 수 있을 만큼 설명을 쓰고, 리뷰를 맞는 에이전트에게 다시 가져다주는 일입니다.

리뷰와 에이전트를 한곳에 두면 수정도 맞는 브랜치에 들어갑니다. 메시지는 코멘트가 어떤 풀 리퀘스트와 어떤 브랜치에 속하는지 에이전트에게 알려 주고, 병합하지 말고 다른 풀 리퀘스트도 열지 말고 그 브랜치에 푸시하라고 요청합니다.

제한 사항

  • GitHub.com과 GitLab(gitlab.com 또는 연결한 셀프 호스팅 인스턴스). Bitbucket과 Azure DevOps는 브라우저에서 자체 새 풀 리퀘스트 페이지를 엽니다. GitHub Enterprise는 지원하지 않습니다.
  • 병합, 승인, 스레드 해결은 GitHub 또는 GitLab에서 합니다.
  • 리뷰 알림은 이 컴퓨터에서 AgentsRoom으로 만든 풀 리퀘스트를 대상으로 하며, 앱이 실행 중일 때 3분마다 확인합니다.
  • 상태는 배지가 화면에 보이는 동안 새로 고쳐집니다. 에이전트 카드와 티켓에는 마지막으로 확인한 상태가 표시됩니다.
  • 프로젝트 폴더에서 일하는 에이전트는 그 폴더의 브랜치를 공유하므로 카드에 풀 리퀘스트가 표시되지 않습니다. 폴더의 풀 리퀘스트는 Changes 탭에 있습니다.
  • AI가 없을 때(오프라인, 로컬 모드, 초안 작성 실패)에도 양식은 열리고, 커밋 내용으로 채워지며, 그 사실을 알려 줍니다.

자주 묻는 질문

다른 질문하기
Claude Code나 Codex가 AgentsRoom에서 풀 리퀘스트를 만들 수 있나요?
네. 에이전트가 브랜치에서 작업을 마치면 Changes 탭의 푸시 옆, '워크트리' 보기의 해당 행, 또는 에이전트의 오른쪽 클릭 메뉴에서 'PR 만들기'를 클릭하세요. AgentsRoom은 필요하면 브랜치를 푸시하고, GitHub에서는 풀 리퀘스트를, GitLab에서는 머지 리퀘스트를 엽니다. 에이전트가 Claude Code, Codex 또는 다른 어떤 CLI를 실행하든 마찬가지입니다.
AgentsRoom은 풀 리퀘스트의 제목과 설명을 어떻게 작성하나요?
AI가 기준 브랜치 이후의 브랜치 diff, 커밋, 연결된 티켓을 바탕으로 초안을 쓰고, 티켓 줄은 AgentsRoom이 직접 추가합니다(트래커에서 가져온 티켓이라면 키와 함께 Closes도 추가합니다). 무엇이든 보내기 전에 두 가지 모두 읽고 수정할 수 있습니다. AI를 쓸 수 없으면 커밋 내용으로 양식이 채워집니다.
에이전트가 리뷰 코멘트를 고치게 하려면 어떻게 하나요?
풀 리퀘스트 배지에서 해결되지 않은 코멘트 수를 클릭한 다음 '코멘트를 에이전트에게 보내기'를 누르세요. 해결되지 않은 모든 스레드가 파일, 줄, 작성자, 코드 발췌와 함께 선택된 상태로 나타납니다. 그대로 둘 항목의 선택을 해제하고, 그 체크아웃의 에이전트나 그 안에서 시작할 새 에이전트를 골라 보내세요. 에이전트는 이를 메시지 하나로 받아 수정하고 같은 브랜치에 푸시합니다.
GitLab 머지 리퀘스트, Bitbucket, Azure DevOps에서도 작동하나요?
GitLab은 지원합니다. gitlab.com이나 연결한 셀프 호스팅 인스턴스에서 쓸 수 있으며, 머지 리퀘스트를 만들려면 api 범위가 있는 토큰이 필요합니다. Bitbucket과 Azure DevOps는 AgentsRoom에 연결할 방법이 없어서, 'PR 만들기'가 브라우저에서 자체 새 풀 리퀘스트 페이지를 엽니다. GitHub Enterprise는 지원하지 않습니다.
휴대폰에서 풀 리퀘스트를 만들고 지켜볼 수 있나요?
네. 모바일 앱에서는 프로젝트의 '워크트리' 화면이 체크아웃마다 풀 리퀘스트를 상태, 리뷰 결과, 해결되지 않은 코멘트와 함께 보여 주고, 'PR 만들기'와 '코멘트를 에이전트에게 보내기'를 제공합니다. 작업은 데스크톱이 하므로 데스크톱이 실행 중이어야 합니다. 리뷰 알림을 탭하면 그 화면이 열립니다.
AgentsRoom이 풀 리퀘스트를 병합하거나 승인할 수 있나요?
아니요. 병합, 승인, 스레드 해결은 일부러 GitHub나 GitLab에 남겨 두었습니다. 에이전트에게 보내는 메시지도 병합하지 말고 다른 풀 리퀘스트를 열지 말라고 요청합니다. AgentsRoom은 만들고, 지켜보고, 리뷰를 에이전트에게 다시 전달합니다.

함께 보면 좋은 기능

브랜치는 에이전트가 씁니다. 풀 리퀘스트는 그 뒤를 따라옵니다.

AgentsRoom은 macOS, Windows, Linux에서 실행되며, 모바일 앱으로 휴대폰에서 리뷰를 지켜볼 수 있습니다.

AgentsRoom 다운로드무료

컴패니언 앱: 이동 중에도 에이전트를 모니터링

Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.

버그와 요청을 공개 백로그로 바로 보내세요.