AI 에이전트 작업 흐름에 인간이 개입하는 리뷰 창구
코딩 에이전트가 계획을 세우거나 코드를 수정할 때, 브라우저에서 바로 내용을 확인하고 주석을 달아 피드백을 보낼 수 있습니다. 이는 로컬에서 실행되는 브라우저 기반 리뷰 도구로, 에이전트와 사람 사이의 의사소통 단절을 메워줍니다. 에이전트가 만든 계획이나 코드 변경 사항을 시각적으로 검토하고, 승인하거나 수정 요청을 보내는 과정을 하나의 창구에서 처리합니다.
에이전트 작업 흐름에 끼어드는 리뷰 창구
Plannotator Inbox는 여러 에이전트 작업 사이에서 필요한 결정 사항, 프로토타입, 계획 등을 한눈에 보여주는 로컬 창구입니다. 에이전트가 질문을 하거나 파일을 전달하면 이 창구에서 답을 하거나 주석을 달고 전송할 수 있습니다. 이 과정에서 에이전트 세션이 열려 있을 필요가 없으며, 답변은 질문한 세션으로 바로 전달됩니다. Claude Code, Pi, OpenCode는 플러그인으로 연결되고, 다른 에이전트는 MCP를 통해 접근합니다.
계획과 코드 변경 사항의 시각적 검토
에이전트가 계획을 만들면 브라우저에서 마크다운 리뷰 화면이 자동으로 열립니다. 사용자는 계획에 주석을 달고 승인하거나 거부할 수 있으며, 거부 시 구조화된 피드백이 에이전트로 돌아가 수정을 유도합니다. 코드 리뷰 기능은 로컬 변경 사항이나 GitHub, GitLab의 풀 리퀘스트를 가져와 차이를 비교하고 주석을 달 수 있게 합니다. Git, GitButler, Jujutsu, Perforce 등 다양한 버전 관리 도구와 호환됩니다.
로컬 우선의 프라이버시와 네트워크 동작
이 도구는 사용량 텔레메트리나 분석을 수집하지 않으며, 계획, 차이, 주석, 초안, 설정은 기본적으로 로컬에 유지됩니다. 앱이 로드될 때 최신 릴리스 확인을 위해 GitHub에 요청을 보내지만, 이때 계획이나 리뷰 내용은 전송되지 않습니다. 로컬 Git 코드 리뷰 시 기본 브랜치를 감지하기 위해 원본 리모트에 git ls-remote를 호출할 수 있으나, 이 역시 로컬 차이를 전송하지 않습니다. 이 원격 조회는 리뷰가 열리거나 페이지가 로드될 때만 발생하며, 설정을 통해 완전히 비활성화할 수 있습니다.
설치와 에이전트 연동 방식
설치 프로그램은 plannotator 바이너리를 설치하고, 설치된 에이전트를 자동 감지하여 훅, 스킬, 슬래시 명령을 구성합니다. 최소 설치 옵션(--minimal)을 사용하면 바이너리만 설치하고 에이전트별 설정은 수동으로 처리할 수 있습니다.
사용 전 확인해야 할 보안과 한계
릴리스 바이너리는 SHA256 사이드카와 SLSA 프로브넌스 증명을 제공하며, CycloneDX SBOM을 통해 의존성을 검증할 수 있습니다. 원격 모드(SSH, devcontainer)에서는 서버가 모든 인터페이스에 로그인 없이 리스닝하므로, 신뢰할 수 없는 네트워크에 포트가 노출되지 않도록 주의해야 합니다. 링크 공유 기능은 비공개가 아니며, URL 조각에 포함된 내용은 암호화되지 않을 수 있으므로 민감한 정보를 공유할 때는 Workspaces 호스팅 서비스를 고려해야 합니다. 이 도구는 에이전트와 사람 사이의 리뷰 단계를 보완하지만, 에이전트 자체의 코드 생성 품질을 보장하지는 않습니다.