backnotprop/plannotator
AI 코딩 에이전트와 협업하는 주석·검토 워크스페이스 Plannotator
원제 backnotprop/plannotator
스타 11,821당일 +866TypeScript
Key Point
여러 AI 에이전트와의 개발 협업 워크플로가 표준화되면서, 에이전트의 결정·코드를 한 곳에서 검토하고 피드백 루프를 닫는 도구 필요성이 급증했기 때문이다.
핵심 요약
- AI 코딩 에이전트(Claude Code, Copilot CLI, Pi, OpenCode, DeepSeek 등)와 협업하기 위한 브라우저 기반 검토 플랫폼으로, 계획·사양·마크다운·HTML 주석 달기, 코드 리뷰, 팀 공유 기능을 제공한다.
- 새 기능 Plannotator Inbox는 에이전트가 제시한 결정, 프로토타입, 계획을 한 창에서 보고 한 번의 클릭으로 피드백을 에이전트에게 돌려보내는 비동기 검토 레이어다.
- 코드 리뷰는 Git, GitHub, GitLab, GitButler, Jujutsu, Perforce 등 다양한 VCS를 지원하며, 로컬 변경사항이나 원격 PR/MR에 대해 diff에 주석을 달고 제안한 내용을 에이전트에게 전송할 수 있다.
- Herdr Annotate는 터미널에서 마크다운 문서와 에이전트 응답을 주석 달 수 있게 하고, 터미널·앱 검토 이력이 Plannotator 데이터 디렉토리에 누적되어 함께 관리된다.
- 모든 주요 AI 에이전트와 통합되며, 설치 스크립트가 에이전트를 자동 감지해 플러그인·훅·슬래시 명령어를 구성한다.
- 계획이 없는 상태에서 Claude Code의 빠른 모드, Copilot CLI의 플랜 모드, Codex 실험적 Stop 훅 등 에이전트 고유 진입점으로도 자동 열린다.
- 계획·주석·초안·기록·설정이 기본적으로 로컬에 저장되며, 네트워크 기능(URL 주석 처리, GitHub/GitLab 리뷰, AI 질문)은 필요할 때만 외부 통신한다.
- 깃허브 릴리스 확인 시 내용 없이 요청만 전송되고, 지역 Git 코드 리뷰는 git ls-remote로 기본 브랜치 감지 시에만 통신하며 `PLANNOTATOR_GIT_REMOTE_CHECK=0`으로 비활성화할 수 있다.
- 작은 마크다운은 URL 조각에 압축되고, 큰 콘텐츠는 AES-256-GCM 암호화 후 7일 후 만료되는 페이스트 서비스에 저장되며, PrivateBin과 같은 모델을 따른다.
- 팀 공유는 레거시 링크 공유에서 Workspaces 호스팅 제품으로 이동 중이며, 개인 어시스턴트(Grok Bot, Muse, Hermes, OpenClaw)도 MCP를 통해 지원된다.
- VS Code 확장, Obsidian 자동 저장, Bear 노트, Notion 통합으로 검토된 계획을 외부 도구에 내보낼 수 있고, SSH/devcontainer 환경에서는 고정 포트 19432 또는 커스텀 포트로 작동한다.
- 배포 이진 파일에는 SHA256 부호가 동반되며, v0.17.2부터 SLSA 증명서와 CycloneDX SBOM을 포함하고, Grype로 평가 후 GitHub/Sigstore 증명서로 서명된다.
- Vim 키 바인딩은 설정에서 선택적으로 활성화되며, j/k로 블록 이동, v/V로 선택, 공간/c/d/m/t로 주석 도구를 조작할 수 있다.
- TypeScript로 작성되었으며, 환경 변수와 `~/.plannotator/config.json`으로 포트, 브라우저, 데이터 디렉토리, 공유 URL, Jina Reader 활성화 등을 설정할 수 있다.
저장소 보기 ↗github.com