backnotprop/plannotator

Plannotator – AI 코드 보조 도구를 위한 로컬 브라우저 기반 리뷰 UI

무엇인가요 – Plannotator는 클라우드 서비스가 필요 없는 데스크톱 전용 도구로, AI 기반 코드 보조 도구(Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, Pi 등)가 계획, HTML, 또는 완성된 코드를 생성할 때마다 웹 UI(또는 Herdr Annotate를 통해 터미널 UI)를 열어줍니다. 콘텐츠에 주석을 달고, 차이점에 대한 의견을 남기며, 피드백을 에이전트로 다시 전달하여 출력을 수정할 수 있습니다.

핵심 기능

• 계획/문서 리뷰 – 마크다운 형식의 계획, 사양서, 또는 URL로 가져온 페이지에 주석을 달 수 있습니다. UI는 인라인 주석과 "피드백 보내기" 버튼을 표시합니다.
• 코드 리뷰 – 로컬 변경 사항 또는 원격 PR/MR URL(GitHub, GitLab, GitButler, Perforce)에서 작동합니다. 파일 트리와 양측 비교 차이점을 표시하여 주석 달기, 스테이징/언스테이징, "LGTM" 응답이 가능합니다.
• HTML 아티팩트 리뷰 – 원시 HTML을 렌더링하고 피드백을 보내기 전에 수정할 수 있습니다.
• AI 인 더 루프 – 연결된 LLM에 리뷰 중인 자료에 대해 질문하거나, AI가 생성한 리뷰를 시작하여 자동으로 주석을 게시할 수 있습니다.
• 터미널 모드 – Herdr Annotate 플러그인이 동일한 UI를 터미널(Herdr TUI를 통해)으로 가져옵니다. 독립형 TUI도 plannotator-tui로 사용 가능합니다.

작동 방식

1. 에이전트가 훅(예: ExitPlanMode)을 트리거합니다.
2. Plannotator의 로컬 서버가 계획 또는 차이점을 수신합니다.
3. 기본 브라우저가 리뷰 UI를 엽니다.
4. 주석을 추가한 후, 도구는 동일한 훅을 통해 구조화된 응답을 다시 전송하여 에이전트가 계속하거나 수정할 수 있도록 합니다.

설치

• macOS, Linux, WSL, Windows PowerShell용 원라인 설치 프로그램으로 plannotator 바이너리를 다운로드하고 설치된 에이전트를 자동 감지한 후 필요한 훅/스킬/명령어를 작성합니다.
• --minimal 플래그는 바이너리만 설치하고 모든 에이전트 전용 통합은 제외합니다.
• 설치 후 각 에이전트별 단계(예: Amp용 플러그인 파일 복사, Claude Code용 마켓플레이스 항목 추가 등)를 따릅니다. README에는 각 에이전트의 자세한 설정 링크가 포함되어 있습니다.

사용 단축키

/plannotator-annotate README.md                # 로컬 파일 주석 달기
/plannotator-annotate https://example.com     # URL 가져와서 주석 달기
/plannotator-review                           # 현재 git 차이점 리뷰
/plannotator-review https://github.com/...    # PR/MR 리뷰
/plannotator-last                             # 에이전트의 마지막 응답 주석 달기
plannotator sessions                          # 저장된 세션 목록 보기/열기

(Codex의 경우 명령어는 ! 또는 $로 시작합니다.)

통합

• VS Code 웹뷰, Obsidian 백업 자동 저장, Bear 노트, GitHub/GitLab PR 가져오기, GitButler 워크스페이스, Perforce, 원격 SSH/개발 컨테이너 포트 포워딩.
• 모든 통합은 선택 사항이며, 핵심 UI는 이들 없이도 작동합니다.

개인정보 및 네트워킹

• 사용자 추적 없음. 모든 계획, 차이점, 주석, 설정은 로컬 머신에 보관되며, 명시적으로 공유하지 않는 한 네트워크에 전송되지 않습니다.
• 외부 리소스 요청 시에만 네트워크 호출이 발생합니다: URL 가져오기(Jina Reader 기본), GitHub/GitLab에서 PR 데이터 가져오기, 설정된 LLM 제공자에게 질문 보내기, 또는 선택적 링크 공유 서비스 사용(대용량 데이터는 AES-256-GCM로 클라이언트 측에서 암호화).
• 설치 프로그램은 최신 릴리스를 GitHub에서 확인하지만, 사용자의 콘텐츠는 전송하지 않습니다.

공유

• 작은 마크다운 스니펫은 URL 프래그먼트에 인코딩되어 링크를 가진 누구나 볼 수 있습니다.
• 큰 데이터는 단축 링크 서비스를 사용하며, 저장되는 것은 암호화된 데이터뿐이며, 복호화 키는 프래그먼트에 존재합니다.
• 팀 협업용으로 호스팅된 "워크스페이스" 제품이 언급되지만, 오픈소스 앱은 순수하게 로컬에 머무릅니다.

보안

• 모든 바이너리 릴리스에는 SHA-256 체크섬과 SLSA 프로반스가 포함됩니다.
• CycloneDX SBOM과 Grype 스캔이 각 릴리스에 첨부되며, README에는 검증 명령어가 안내되어 있습니다.

제거 / 완전 제거

• plannotator uninstall은 바이너리와 설정을 제거하지만 로컬 데이터는 유지합니다.
• plannotator uninstall --purge는 확인 프롬프트 후 모든 Plannotator 데이터를 삭제합니다.

결론 – Plannotator는 AI 코드 보조 도구 사용 시 개발자가 항상 개입할 수 있도록 하는 집중형 로컬 호스팅 UI입니다. 기업 기밀 코드를 제3자 서비스에 전송하지 않고도 계획 리뷰, 코드 차이점 주석 달기, HTML 아티팩트 피드백을 제공합니다.