TAU-HOME.COM
LOADING

Plannotator: AI 코딩 에이전트 작업 검토와 피드백 전송을 돕는 로컬 브라우저 워크스페이스

Claude Code, Codex, Copilot CLI 등 터미널 기반 AI 코딩 에이전트의 계획서, HTML 결과물, 코드 diff를 로컬 브라우저에서 검토하고 한 번의 클릭으로 피드백을 전달하는 오픈소스 도구 Plannotator를 살펴봅니다.

tau · 2026년 11월 17일

#AI 에이전트 #코드 리뷰 #개발 도구 #Claude Code #오픈소스

Plannotator: AI 코딩 에이전트 작업 검토와 피드백 전송을 돕는 로컬 브라우저 워크스페이스

터미널 환경에서 스스로 코드를 작성하고 수정하는 자율형 코딩 에이전트의 보급이 빨라지면서, 에이전트가 제시하는 작업 계획과 코드 수정안을 사람이 어떻게 검토하고 통제할 것인가가 개발 실무의 주요 과제로 떠올랐습니다. 오픈소스 프로젝트 Plannotator는 Claude Code, Codex, Copilot CLI 등 다양한 에이전트의 중간 산출물을 로컬 브라우저 화면에서 한눈에 확인하고, 인라인 주석을 달아 다음 턴 프롬프트로 전송하도록 설계된 검토 인터페이스 도구입니다.

AI 코딩 에이전트의 계획서 및 코드 diff를 검토하는 Plannotator 브라우저 인터페이스

이미지 출처: https://github.com/backnotprop/plannotator

2026년 11월 13일 기준 GitHub 스타 10,241개를 기록하고 v0.28.63 릴리스를 배포한 이 도구는 에이전트와의 협업 과정에서 발생하는 피드백 병목을 해소하는 데 초점을 맞추고 있습니다.

터미널 에이전트 작업 검토가 지니던 구조적 불편

터미널 기반 코딩 에이전트는 복잡한 기능을 구현하기 전에 먼저 마크다운 문서 형태로 실행 계획을 작성하거나, 수정한 코드 변경점(diff)을 터미널 출력 창에 쏟아냅니다. 하지만 터미널 화면 특성상 수백 줄에 달하는 변경 사항이나 렌더링된 웹 화면(HTML 아티팩트)을 직관적으로 파악하기 어렵습니다.

수정이 필요한 특정 줄에 피드백을 전달하려면 개발자가 터미널에 줄 번호와 파일 경로를 직접 손으로 타이핑해 설명해야 했습니다. 이 과정에서 맥락이 어긋나거나 지시가 부정확해져 에이전트가 엉뚱한 방향으로 코드를 고치는 일이 잦았습니다.

Plannotator는 에이전트가 계획을 세우거나 작업을 마쳤을 때 로컬 웹 브라우저 창을 띄워, 개발자가 깃허브(GitHub) 코드 리뷰 창처럼 익숙한 화면에서 작업물을 검토할 수 있게 지원합니다.

지원 환경과 주요 기능: 계획서부터 코드 변경점까지

Plannotator는 플러그인, 훅(Hook), CLI 명령어뿐 아니라 표준 프로토콜인 MCP(Model Context Protocol) 연동을 지원합니다. 지원 도구 목록에는 Claude Code, Codex, Copilot CLI, Gemini CLI, Antigravity, Kiro, Droid, Amp, Pi 등이 포함되며, Plannotator Inbox를 통해 Grok Bot, Muse, Hermes, OpenClaw 같은 개인 비서 도구와도 연결됩니다.

  • 마크다운 계획서 검토 (Plan Mode): 에이전트가 작업 계획을 수립하면 브라우저에 마크다운 리뷰 창이 열립니다. 특정 문장에 마우스 드래그로 주석을 남기면, 해당 주석들이 취합되어 에이전트의 다음 턴 입력 메시지로 자동 전달됩니다.
  • HTML 아티팩트 시각 렌더링: 에이전트가 생성한 웹 프로토타입이나 보고서 HTML 파일을 브라우저 화면 그대로 렌더링해 확인하고, 시각적 요소 위에 직접 피드백을 기록할 수 있습니다.
  • 다양한 버전 관리 시스템 기반 코드 리뷰: 로컬 미커밋 변경 사항뿐 아니라 GitHub PR, GitLab MR diff를 검토할 수 있습니다. Git 외에도 GitButler, Jujutsu(jj), Perforce(p4) 환경을 함께 지원합니다.
  • 터미널 중심 작업자를 위한 TUI 제공: 브라우저 창 전환을 선호하지 않는 개발자를 위해 터미널 안에서 직접 마크다운과 에이전트 응답을 검토하는 Herdr Annotate 플러그인과 독립 실행형 Plannotator TUI를 함께 갖추었습니다.

설치 및 실무 사용 흐름

도구 연동 후 일상적인 개발 작업 흐름은 슬래시 명령어와 CLI 도구를 통해 실행됩니다. Codex 환경에서는 슬래시 명령 대신 !plannotator 접두사나 관련 스킬을 활용할 수 있습니다.

로컬 마크다운 문서나 웹 문서 URL을 검토할 때는 전용 주석 명령을 호출합니다.

/plannotator-annotate README.md
/plannotator-annotate report.html --render-html
/plannotator-last

코드 변경점을 리뷰할 때는 로컬 작업 트리 검토나 원격 저장소 풀 리퀘스트 URL을 넘겨 브라우저 리뷰 화면을 즉시 엽니다.

/plannotator-review
/plannotator-review https://github.com/owner/repo/pull/123
plannotator review --gitbutler

에이전트가 남긴 질문이나 비동기 요청을 한곳에서 모아 처리할 때는 로컬 인박스 명령을 실행합니다.

plannotator inbox

인박스 인터페이스에서는 에이전트 세션이 대기 상태로 자원을 점유하지 않으며, 개발자가 답변을 입력하고 전송 버튼을 누르는 시점에 질문을 남겼던 원래 에이전트 세션으로 피드백이 반환됩니다.

네트워크 동작 및 도입 시 주의사항

Plannotator는 사용자 행동 추적용 텔레메트리나 사용량 분석 통계를 수집하지 않으며, 작업 계획서와 diff, 주석 데이터는 기본적으로 로컬 환경에 보관됩니다. 다만 실무 환경 도입 전 확인해두어야 할 네트워크 동작 특성이 있습니다.

첫째, 리뷰 화면이나 아카이브 화면을 로드할 때마다 새 릴리스 여부를 확인하기 위해 GitHub API 호출이 발생합니다. 계획서 내용 자체는 전송되지 않지만, 현재 릴리스 확인 요청을 비활성화하는 옵트아웃 옵션은 제공되지 않습니다.

둘째, 로컬 Git 리뷰 시 브랜치 기준점을 파악하기 위해 원격 저장소(origin)를 대상으로 git ls-remote 쿼리가 실행됩니다. 저장소 diff 내용이 외부로 전송되지는 않으나, 네트워크 격리 환경이 필요한 경우 --no-git-remote-check 플래그나 설정 파일(~/.plannotator/config.json)의 gitRemoteCheck: false 옵션으로 기능을 꺼야 합니다.

셋째, 협업 기능 정책에 변동이 있습니다. 기존 오픈소스 비동기 링크 공유 기능은 단계적 사용 중단(deprecated) 절차를 밟고 있으며, 팀 단위 공유 기능은 상용 호스팅 제품인 Workspaces로 이전되고 있습니다. 사내 보안 정책상 외부 서버와의 데이터 통신을 엄격히 제한해야 하는 팀이라면 로컬 단독 사용 범위를 명확히 설정하고 도입하는 편이 안전합니다.

출처

Impact-Site-Verification: 9b3ebd10-6c45-44cf-a014-5b8c19b7b285