TL;DR

Plannotator는 AI 코딩 에이전트의 계획, 문서, HTML 산출물, 코드 Diff를 로컬 브라우저에서 검토하는 독립 실행형 CLI 도구입니다. 각 에이전트의 Hook, Plugin, Skill과 연결해 구현 전에 계획을 승인하거나 거부하고, 줄 단위 주석과 코드 제안을 에이전트 세션으로 돌려보냅니다. GitHub·GitLab PR과 여러 로컬 버전 관리 방식을 지원하며 기본 데이터는 로컬에 보관하지만 URL 조회, AI 기능, 공유를 사용할 때는 외부 전송 경계를 확인해야 합니다. 여러 에이전트를 함께 쓰는 개발팀이나 계획 단계의 피드백을 시각화하려는 개발자에게 적합하고, 단순한 단일 에이전트 터미널 작업에는 설치 구성이 다소 클 수 있습니다.

핵심 포인트

• Plannotator는 독립 실행형 로컬 도구이자 CLI이며 Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, Pi에 연결되는 AI 코딩 에이전트 리뷰 도구입니다. 에이전트가 만든 계획과 문서, HTML 산출물, 코드 변경을 브라우저에서 열고 주석과 승인 여부를 다시 에이전트 세션으로 보냅니다. 특정 프레임워크에 종속된 Library·SDK가 아니라 여러 에이전트 생태계를 연결하는 Hook·Plugin·Skill 통합 제품이라는 점이 핵심입니다.
• 계획 검토는 에이전트의 `ExitPlanMode` 호출을 Hook이 가로채고 로컬 서버가 계획을 읽은 뒤 브라우저 리뷰 화면을 여는 방식으로 작동합니다. 사용자가 승인하면 에이전트가 계속 진행하고 거부하면 구조화된 피드백과 변경된 계획의 차이가 세션으로 돌아갑니다. 따라서 계획을 읽고 나중에 지시를 고치는 흐름보다 구현 전에 범위와 방향을 교정하는 데 적합합니다.
• 코드 리뷰는 `/plannotator-review`로 로컬 `git diff`를 읽거나 GitHub PR·GitLab MR URL에서 변경 내용을 가져와 파일 트리와 좌우 Diff 화면으로 구성합니다. Diff의 특정 줄에 댓글과 코드 제안을 남기고 파일을 stage·unstage한 뒤 피드백이나 `LGTM`을 에이전트에게 반환할 수 있습니다. Git, GitButler, Jujutsu `jj`, Perforce `p4`, GitHub, GitLab을 함께 지원하므로 여러 코드 협업 방식에서 같은 리뷰 인터페이스를 사용할 수 있습니다.
• 기본 데이터는 로컬에 남고 사용량 Telemetry와 Analytics를 수집하지 않지만 URL 가져오기, AI 질의, PR·MR 조회, 링크 공유에서는 선택한 외부 서비스로 내용이 이동합니다. 작은 Markdown 공유는 URL Fragment에 평문으로 저장되고 큰 Markdown과 Raw HTML은 AES-256-GCM으로 암호화한 뒤 7일 만료 Paste에 업로드되며 복호화 키는 Fragment에 남습니다. 팀 협업용 Link Sharing은 Deprecated 방향이고 Workspaces가 주된 경로이므로 장기적인 호스팅 협업이 필요하면 현재 제품 방향을 확인해야 합니다.

이미지 분석