Bugbot

풀 리퀘스트용 AI 코드 리뷰

Bugbot은 풀 리퀘스트를 리뷰하고 버그, 보안 이슈, 코드 품질 문제를 찾아줘.

Bugbot에는 무료 티어가 있어: 모든 사용자는 매달 제한된 수의 무료 PR 리뷰를 받을 수 있어. 한도에 도달하면 다음 결제 주기까지 리뷰가 일시 중단돼. 무제한 리뷰(표준 오남용 방지 가드레일 적용)를 위해 언제든 14일 무료 Pro 체험으로 업그레이드할 수 있어.

작동 방식

Bugbot은 PR diff를 분석하고, 설명과 수정 제안을 담은 댓글을 남겨. 각 PR이 업데이트될 때 자동으로 실행되거나, 트리거하면 수동으로 실행돼.

• 모든 PR 업데이트마다 자동 리뷰 실행
• 어떤 PR에서든 cursor review, bugbot run, 또는 cursor run이라고 댓글 달아 수동 트리거
• Fix in Cursor 링크로 이슈를 Cursor에서 바로 열기
• Fix in Web 링크로 이슈를 cursor.com/agents에서 바로 열기

설정

Cursor 관리자 권한과 GitHub 조직 관리자 권한이 필요해.

1. cursor.com/dashboard로 가
2. Bugbot 탭으로 이동해
3. Connect GitHub을 클릭해 (이미 연결돼 있다면 Manage Connections)
4. GitHub 설치 과정을 따라 진행해
5. 대시보드로 돌아와 특정 리포지토리에서 Bugbot을 활성화해

설정

Individual

리포지토리 설정

설치 목록에서 리포지토리별로 Bugbot을 켜거나 꺼. Bugbot은 네가 만든 PR에서만 돌아가.

개인 설정

• 댓글에 cursor review 또는 bugbot run을 남겨 언급됐을 때만 실행
• 이후 커밋은 건너뛰고 PR당 한 번만 실행

분석

규칙

프로젝트별 리뷰 컨텍스트를 제공하려면 .cursor/BUGBOT.md 파일을 만들어. Bugbot은 항상 루트 .cursor/BUGBOT.md 파일과, 변경된 파일에서 상위 디렉터리로 올라가며 발견한 추가 파일들을 포함해.

project/
  .cursor/BUGBOT.md          # 항상 포함됨 (프로젝트 전역 규칙)
  backend/
    .cursor/BUGBOT.md        # backend 파일을 리뷰할 때 포함됨
    api/
      .cursor/BUGBOT.md      # API 파일을 리뷰할 때 포함됨
  frontend/
    .cursor/BUGBOT.md        # frontend 파일을 리뷰할 때 포함됨

예시 .cursor/BUGBOT.md

# 프로젝트 리뷰 가이드라인

## 보안 중점 영역

- API 엔드포인트에서 사용자 입력 검증
- 데이터베이스 쿼리의 SQL 인젝션 취약점 점검
- 보호된 라우트에 대한 적절한 인증 보장

## 아키텍처 패턴

- 서비스에 의존성 주입 사용
- 데이터 액세스에 리포지토리 패턴 적용
- 커스텀 에러 클래스를 활용한 적절한 에러 처리 구현

## 흔한 이슈

- React 컴포넌트에서의 메모리 누수 (useEffect cleanup 확인)
- UI 컴포넌트의 에러 바운더리 누락
- 일관되지 않은 네이밍 컨벤션 (함수는 camelCase 사용)

요금제

Bugbot은 두 가지 플랜을 제공해: Free랑 Pro.

무료 플랜

모든 사용자는 매달 제한된 횟수의 무료 PR 리뷰를 받아. 팀에서는 각 팀원이 자기 몫의 무료 리뷰를 받게 돼. 한도에 도달하면 다음 결제 주기까지 리뷰가 일시 중지돼. 무제한 리뷰를 쓰려면 언제든 14일 무료 Pro 체험으로 업그레이드하면 돼.

Pro 티어

Individuals

정액제

모든 리포지토리에서 월 최대 200개의 PR에 대해 Bugbot 리뷰를 무제한으로 월 $40에 이용할 수 있어.

시작하기

계정 설정에서 구독해.

문제 해결

Bugbot이 제대로 작동하지 않을 때:

1. 자세한 로그와 요청 ID를 확인하려면 cursor review verbose=true 또는 bugbot run verbose=true를 댓글로 남겨서 verbose 모드를 활성화해줘
2. Bugbot이 저장소에 접근할 수 있는지 권한을 확인해줘
3. GitHub 앱이 설치되어 있고 활성화되어 있는지 설치 상태를 확인해줘

문제를 보고할 때는 verbose 모드에서 나온 요청 ID를 꼭 포함해줘.

자주 묻는 질문

Bugbot는 프라이버시 모드 규정을 준수해?

응, Bugbot는 Cursor와 동일한 프라이버시 준수 기준을 따르고, 다른 Cursor 요청과 똑같이 데이터를 처리해.

무료 플랜 한도를 다 쓰면 어떻게 돼?

월간 무료 플랜 한도를 다 쓰면 다음 결제 주기까지 Bugbot 리뷰가 일시 중지돼. 무제한 리뷰를 위해 14일 무료 Pro 체험으로 업그레이드할 수 있어(표준 오남용 방지 가이드 적용).