내 AI 코딩 에이전트가 Bitbucket PR을 읽을 수 없어서, 해결했습니다

Source: Dev.to

개요

제가 겪은 답답한 상황을 공유합니다.

저는 Claude Code(Anthropic의 터미널 기반 코딩 에이전트)를 사용하고 있는데, 정말 도움이 됩니다. 명령을 실행하고, 파일을 읽고, 문제 해결을 도와주죠. GitHub 프로젝트에서는 gh pr view 같은 명령을 이용해 PR 상태를 확인하고 리뷰까지 할 수 있었습니다.

하지만 Bitbucket 프로젝트로 옮기니 AI 어시스턴트가 갑자기 눈이 멀었습니다. “죄송합니다, 접근할 수 없습니다”라는 메시지가 계속 나왔습니다. CLI 도구가 없으니 PR diff를 가져오거나 상태를 확인하거나, AI‑지원 개발 흐름에 필수적인 Git 플랫폼 작업을 할 방법이 없었습니다.

그래서 직접 만들었습니다.

이것이 무엇인가

Bitbucket Cloud용 gh‑스타일 CLI입니다. 복잡한 기능은 없고, 부족했던 부분만 채웠습니다:

# 한 번 인증
bb auth login

# 이제 터미널(및 AI 에이전트)에서 Bitbucket과 상호작용 가능
bb pr list
bb pr view 42
bb pr diff 42
bb repo list

이제 Claude Code에게 “열린 PR을 확인하고 요약해줘”라고 물어보면 실제로 수행합니다. bb pr list --json을 실행하고 출력을 파싱해 필요한 정보를 제공합니다. “PR #15의 diff를 리뷰해줘” 역시 bb pr diff 15를 실행하면 바로 작업이 가능합니다.

중요한 점

컨텍스트 감지

Bitbucket 원격이 설정된 git 저장소에 있으면 작업 공간과 저장소를 자동으로 파악합니다:

cd my-bitbucket-project
bb pr list  # 별도 옵션 없이 바로 동작

JSON 출력 전역 적용

스크립팅과 AI 에이전트 모두에 필수적입니다:

bb pr list --json | jq '.[] | select(.state == "OPEN")'

표준 npm 설치

npm install -g @pilatos/bitbucket-cli

지원 기능

• 인증
• 저장소: 복제, 생성, 목록 조회, 보기, 삭제
• 풀 리퀘스트: 생성, 목록 조회, 보기, 편집, diff, 병합, 승인, 거절, 체크아웃

아직 지원되지 않는 기능: 파이프라인, 이슈 트래커 연동, 코드 검색. 기본적인 80 % 사용 사례는 커버합니다.

공유 이유

Bitbucket 프로젝트에서 AI 코딩 도구를 사용하면서 저와 같은 벽에 부딪힌 분들이 있다면, 이제 이 도구를 활용할 수 있습니다.

기여하고 싶다면—오픈 소스이며 TypeScript로 작성된 깔끔한 아키텍처를 가지고 있습니다. 새로운 명령 추가도 간단합니다. 파이프라인 지원은 누군가가 도전한다면 멋진 추가가 될 것입니다.

• GitHub:
• Docs:

Atlassian과는 무관합니다. 단지 AI 도구가 실제로 작동하기를 원했던 개발자일 뿐입니다.