당신의 일을 원한 적 없는 리뷰어

2026년에 사람들이 논쟁하는 AI 코딩 에이전트는 대부분 당신의 코드를 쓰려 한다. PR-Agent는 그것을 읽으려 한다.
별 1만 5539개, 위치는 The-PR-Agent/pr-agent, README는 이제 이 대화를 너무 많이 해본 사람이 쓴 듯한 문장으로 시작한다. "오리지널 오픈소스 PR 리뷰어. 이 프로젝트는 Qodo 무료 티어가 아닙니다."
그 문장이 많은 일을 한다. PR-Agent는 Qodo의 오픈소스 리뷰어로 시작해, 모든 팀이 조용히 설치하고는 잊어버리는 물건이 되었다. 이후 독립 조직으로 옮겼고, 이제 셀프 호스팅이 벤더의 무료 플랜과 같지 않다고 분명히 말해야 한다. 타당하다. 구분은 중요하다. 하나는 당신이 돌리는 도구이고, 다른 하나는 당신을 돌리는 서비스다.
하는 일은 명령 네 개
제품 전체가 풀 리퀘스트 위의 슬래시 명령 네 개다.
/describe는 PR 설명을 쓴다. 무엇이 바뀌었고 왜인지, 리뷰어가 무엇을 먼저 봐야 하는지. /review는 리뷰를 한다. 가능한 버그, 보안 우려, 빠진 테스트, 파일 나머지와의 불일치. /improve는 구체적인 코드 변경을 제안한다. /ask는 스레드에서 diff에 대한 질문에 답하고, diff를 맥락으로 쓴다.
각각이 LLM 호출 한 번이다. README는 약 30초, 낮은 비용이라고 적는데, 그게 나머지 모든 것을 규정한 설계 제약이다. 에이전트 루프도, 도구 호출 트리도, 다단계 계획도 없다. 프롬프트 하나, 응답 하나, 댓글 하나.
별것 없게 들리지만, 이것이 대체한 것을 떠올려 보라. 오후 6시에 1400줄짜리 PR을 열고 대충 훑는 리뷰어.
설치
세 가지 경로가 있고, 생각할 거리가 적은 순서로 적는다.
GitHub Action은 워크플로 파일 하나다. .github/workflows/pr-agent.yml에 넣으면 된다.
on: pull_request: types: [opened, synchronize]
uses: the-pr-agent/pr-agent@main
env: OPENAI_KEY, GITHUB_TOKEN
설정은 이게 전부다. 새 PR과 기존 PR로의 모든 푸시가 자동으로 리뷰된다. 시크릿이 이미 잡혀 있다면 시도하기로 마음먹은 지 20분이면 된다.
CLI는 자기가 쓰지 않은 PR에 로컬로 돌릴 때 쓴다.
pip install "pr-agent[github]"
export OPENAI_KEY=your_key_here
pr-agent --pr_url <url> review
사용하는 플랫폼의 프로바이더 옵션을 설치하거나, 모든 통합을 원하면 pr-agent[all]을 쓰면 된다.
웹훅과 셀프 호스팅은 리뷰가 자기 네트워크 안에서 일어나야 하는 팀을 위한 것이다. Docker 이미지가 있다. GitLab은 웹훅 설정, Bitbucket은 앱 설치, Azure DevOps는 자체 경로를 쓴다. Gitea도 지원한다.

쓸 만하게 만드는 두 가지 엔지니어링 결정
PR 압축. 작은 diff에서만 작동하는 리뷰어는 데모다. PR-Agent는 큰 diff를 위한 압축 전략을 갖고 있다. 잘라내기만 하는 게 아니라 무엇을 남길지 정해서, 모델이 변경의 형태를 여전히 볼 수 있게 한다. 코드베이스에서 가장 화려하지 않고 가장 중요한 부분이다. 대안은 튜토리얼에서는 되고 실제 저장소에서는 넘어지는 도구이기 때문이다.
데이터로서의 프롬프트 설정. 리뷰 카테고리, 톤, 지적하고 싶은 것과 무시하고 싶은 것이 Python이 아니라 TOML 설정 파일에 있다. 코드를 건드리지 않고 카테고리를 추가할 수 있다. '새 DB 컬럼마다 마이그레이션이 있는지 확인' 같은 식으로. 이걸 도입한 팀은 보통 자기 리뷰 문화를 담은 설정을 갖게 되는데, 범용 린터와 선임 엔지니어가 실제로 승인할 만한 것의 차이다.
모델 선택은 LiteLLM을 통해 열려 있다. OpenAI, Claude, Gemini, DeepSeek, Mistral, 그리고 Azure OpenAI, Bedrock, Vertex, Databricks, OpenRouter, Ollama. 기밀성 때문에 로컬 모델을 돌린다면, 거기까지 따라오는 몇 안 되는 리뷰어 중 하나다.
쓸모 있는 리뷰 댓글의 생김새
도움이 되는 리뷰 봇과 음소거되는 봇의 차이는 정확도가 아니다. 댓글이 행동할 수 있을 만큼 구체적인지다.
'여기에 에러 처리를 추가하는 것을 고려하세요'는 아무것도 말하지 않으면서 감시받는 기분만 들게 하므로 없는 것만 못하다. '이 호출은 캐시 미스에서 null을 반환할 수 있는데, 세 줄 아래 호출자가 확인 없이 역참조합니다'는 봇이 70%만 맞아도 유용하다. 확인하는 데 10초면 되니까.
설정 파일이 첫 번째 종류의 댓글에서 두 번째로 넘어가게 해준다. 카테고리를 실제로 코드베이스를 무는 것에 겨눠라. 마이그레이션 커버리지, 재시도 의미론, 새 엔드포인트의 권한 검사, 새 환경 변수가 문서화됐는지. '코드 품질'만 아는 리뷰어는 코드 품질에 대한 댓글을 낸다. 오후 6시에 아무도 필요로 하지 않는 것이다.
계획해 둘 이차 효과도 있다. 봇이 모든 PR에 댓글을 달기 시작하면 사람은 덜 꼼꼼히 본다. 이미 누가 봤으니까. 스타일 때문에 빌드를 실패시키는 린터와 같은 역학이다. 사람이 스타일을 안 보게 훈련된다. 기계적 검사는 봇에게 맡기고 그렇다고 명시하라. 사람의 주의는 봇이 닿지 못하는 곳, 즉 이 변경이 좋은 아이디어인지로 가야 한다.
README에 있는 정직한 결함 하나
/help_docs는 자격 증명 노출 문제의 수정을 기다리며 v0.36.1부터 비활성화되어 있고, 이슈 #2445로 추적된다. 안내는 체인지로그에 묻혀 있지 않고 기능 절에 그대로 있다.
눈에 띄는 게 좋다. 리뷰 봇은 당신의 소스에 읽기 권한을 갖는다. 소스를 읽는 도구의 자격 증명 노출 버그는 크게 알려야 하는 종류다. 유지보수자들은 명령을 조용히 지우고 아무도 모르길 바라는 대신 그렇게 했다.
여기서의 실제 위험면을 일러주는 것이기도 하다. 당신은 제3자의 프롬프트를, 제3자의 모델 위에서, 당신의 diff와 주변 파일에 대한 읽기 권한과 함께 돌리고 있다. 대부분 팀에 합리적인 거래이고 일부에게는 받아들일 수 없는 거래다. 셀프 호스팅 경로가 있는 이유가 바로 그 결정을 당신이 하게 하기 위해서다.
이게 살아남고 더 화려한 에이전트는 못한 이유
2024년과 2025년에 AI 코드 리뷰 스타트업이 수십 개 있었다. 대부분 죽거나 흡수됐다. 사이드 프로젝트로 시작한 오픈소스 리뷰어는 아직 있고, 유지되고, 설정 변경을 계속 내놓는다.
이유는 심심하다. 그 일이 유용한 순간에 그 일 하나를 한다. 리뷰는 PR이 열릴 때 도착하지, 물어보기로 기억할 때 오지 않는다. 댓글은 논의가 이미 일어나는 곳에 나타난다. 비용은 30초와 1센트의 일부다. 배울 것도, 통합할 것도 없다.
워크플로 전체를 넘겨받으려는 에이전트 프레임워크와 비교해 보라. 그쪽은 더 인상적이고 계속 돌리기는 훨씬 어렵다. PR-Agent는 워크플로 파일 하나와 키 하나를 요구한다.
써보려면
저장소 하나에서 Action으로 시작하고, 전부에 걸지 마라. 댓글만 달고 차단은 하지 않는 모드로 2주 돌려라. 팀이 댓글을 읽는지 그냥 지나치는지 금방 알게 되고, 그 답이 이 도구에 설정 비용을 들일지 결정한다.
그다음 실제로 신경 쓰는 카테고리를 적어 설정에 넣어라. 범용 리뷰어는 범용적인 메모를 준다. 가치는 봇이 팀이 늘 잊는 세 가지를 검사할 때 생긴다. 그 세 가지를 알려주는 사람은 당신이다.
관련 글
중국산 안드로이드 시스템 UI의 광고를 끄는, 커뮤니티가 관리하는 탭 표
시스템을 건드리지 않고, 잠금 해제도, 플래싱도 하지 않는다. 제조사가 이미 열어 둔 스위치를 하나씩 뒤집을 뿐이다. 대가는 이 목록을 계속 써 줄 사람이 필요하다는 것이다.
GPT Image 2.6, 토큰 단가는 그대로 두고 청구서를 올렸다
GPT Image 2.6은 2.5의 토큰 단가를 하나도 바꾸지 않았는데 이미지 한 장 값은 올랐다. 작업의 상당 부분이 이제 출력 토큰에서 일어나기 때문이다. 출시 11일째, 가격 구조가 순위표보다 많은 것을 말한다.
IDM을 바깥에서 다시 만든 사람이 손대지 않은 부분을 적어 두었다
Mister Download Manager는 Internet Download Manager의 흐름을 Rust로 다시 구현해 5배 속도와 86개 언어를 내건다. 더 흥미로운 문서는 아무것도 복사하지 않고 어떻게 만들었는지 설명하는 문단이다.
Rune은 에이전트가 자기 작업을 검증할 수 있도록 만든 Rust UI 프레임워크
Rune은 헤드리스로 렌더링하고 요소 트리를 덤프하며 스크립트 입력을 받는다. 스크린샷으로는 얻을 수 없는, diff 가능한 신호를 코딩 에이전트에게 준다. 프레임워크는 프리릴리스이며 풀 리퀘스트를 받지 않는다.