backnotprop/plannotator

Plannotator – AI 에이전트 중심 주석 및 리뷰 도구

이것이 무엇인가

• 로컬에서 실행되는 브라우저 기반(및 터미널 기반) UI로, 다양한 AI 코딩 에이전트(Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, Pi)에 주석을 달고, 리뷰하고, 피드백을 보낼 수 있습니다.
• 에이전트의 명령/스킬 시스템에 연결하여 작동합니다. 에이전트가 계획, HTML 아티팩트 또는 완성된 코드를 생성하면 Plannotator는 웹 페이지(또는 TUI)를 열어 인라인으로 주석을 달고, 그 주석을 에이전트의 다음 메시지로 다시 푸시할 수 있습니다.

주요 기능

영역	할 수 있는 일
계획 및 문서 리뷰	마크다운 계획, 사양 또는 모든 URL을 열고 인라인으로 주석을 달고 계획을 승인하거나 거부할 수 있습니다. 에이전트는 구조화된 피드백을 받고 계획을 수정할 수 있습니다.
코드 리뷰	로컬 diff, 커밋되지 않은 변경 사항 또는 GitHub/GitLab의 원격 PR/MR을 리뷰할 수 있습니다. Git, GitButler, Jujutsu(jj), Perforce(p4)를 지원합니다. 라인에 주석을 달고, 파일을 스테이징/언스테이징하고, "LGTM" 또는 상세한 코멘트를 에이전트로 보낼 수 있습니다.
HTML 아티팩트 리뷰	임의의 HTML(또는 원시 HTML)을 렌더링하고 렌더링된 뷰에 주석을 달 수 있습니다.
터미널 UI (Herdr Annotate)	Herdr 터미널 편집기용 TUI 플러그인으로, 동일한 주석 경험을 명령줄에서 제공합니다. 독립형 TUI(plannotator-tui)도 사용할 수 있습니다.
Ask-AI 및 AI 기반 리뷰	UI 내에서 구성된 LLM에게 리뷰 중인 콘텐츠에 대해 질문하거나, diff에 자동으로 주석을 게시하는 AI 생성 리뷰를 시작할 수 있습니다.
공유	단축 링크(AES-256-GCM 암호화 페이로드)를 통해 계획이나 주석이 달린 문서를 내보내거나 작은 마크다운을 URL 프래그먼트에 직접 포함할 수 있습니다. 레거시 링크 공유 UI는 여전히 존재하지만 호스팅되는 Workspaces 제품으로 대체되고 있습니다.
통합	VS Code 웹뷰, Obsidian 볼트 자동 저장, Bear 노트, SSH/devcontainer 포트 처리.

지원되는 에이전트(기본 제공)

• Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, Pi.
• 설치 프로그램은 이 중 어떤 것이 설치되어 있는지 자동 감지하고 각각에 필요한 훅, 슬래시 명령 또는 스킬을 생성합니다.

설치

# macOS / Linux / WSL – 원라인 설치 프로그램
curl -fsSL https://plannotator.ai/install.sh | bash

# Windows PowerShell
irm https://plannotator.ai/install.ps1 | iex

• 스크립트는 GitHub Releases에서 plannotator 바이너리를 다운로드하고, 설치된 에이전트를 감지하여 필요한 구성 파일(훅, 플러그인, 슬래시 명령 등)을 작성합니다.
• --minimal(또는 PLANNOTATOR_MINIMAL=1)은 바이너리만 설치하며, 에이전트별 추가 설정은 직접 수행해야 합니다.
• 설치 프로그램이 완료된 후 README의 에이전트별 "설치 후" 표를 따라 플러그인 파일을 복사하거나, 마켓플레이스 명령을 실행하거나, 에이전트(Codex, Gemini, Kiro는 추가 단계 없음)를 바로 사용하면 됩니다.

일반적인 워크플로우

1. 계획 모드 – 명령이 필요 없습니다. 에이전트가 계획을 생성하면 Plannotator가 자동으로 브라우저 탭을 엽니다.
2. 주석 달기 – 주석을 추가하고 승인하거나 거부합니다. 피드백은 에이전트 세션으로 다시 전송됩니다.
3. 코드 리뷰 – /plannotator-review(또는 동등한 스킬)를 실행하여 diff 뷰어를 열고 주석을 단 다음 리뷰를 에이전트로 다시 보냅니다.
4. HTML 리뷰 – /plannotator-annotate <file.html> --render-html을 사용하여 렌더링된 페이지를 보고 주석을 답니다.
5. 터미널 – Herdr 내에서 herdr plugin install plannotator/herdr-annotate를 실행하고 TUI에서 동일한 명령을 사용합니다.

개인정보 보호 및 네트워크 동작

• 모든 계획, diff, 주석 및 설정은 기본적으로 사용자 컴퓨터에만 저장됩니다. 원격 측정은 수집되지 않습니다.
• 유일한 외부 요청은 다음과 같습니다:
  • GitHub에서 최신 Plannotator 릴리스를 확인하는 일회성 확인(--no-git-remote-check 또는 PLANNOTATOR_GIT_REMOTE_CHECK=0으로 비활성화 가능).
  • 원격 웹 페이지에 주석을 달 때 선택적 URL 가져오기(기본적으로 Jina Reader 사용).
  • Ask AI 또는 AI 생성 리뷰를 사용할 때 구성된 LLM 공급자에 대한 호출 – 선택한 질문과 관련 컨텍스트만 전송됩니다.
  • 공유 서비스: 단축 링크 업로드는 페이로드를 클라이언트 측에서 암호화하며, 서버는 암호문만 저장합니다.
• 자세한 개인정보 보호정책은 README에 링크되어 있습니다.

제거 / 완전 삭제

plannotator uninstall          # 바이너리, 훅, 설정을 제거하지만 로컬 데이터는 유지
plannotator uninstall --purge # 확인 프롬프트 후 모든 Plannotator 소유 데이터를 삭제

두 명령 모두 우발적인 데이터 손실을 방지하는 안전장치입니다(루트/홈 디렉터리 삭제를 거부하고, 명시적인 purge 입력을 요구하며, dry-run 모드를 제공합니다).

누가 혜택을 볼 수 있나요?

• LLM 기반 코딩 어시스턴트를 사용하고 에이전트가 진행하기 전에 인간이 개입하는 리뷰 단계를 원하는 개발자.
• 전체 저장소를 노출하지 않고 주석이 달린 계획이나 코드 리뷰를 공유해야 하는 팀(암호화된 단축 링크 공유 또는 예정된 Workspaces 제품).
• 시각적 diff/주석 UI를 선호하지만 피드백이 AI 에이전트에 의해 자동으로 소비되기를 원하는 사용자.

결론 Plannotator는 계획, 사양, 코드 diff 및 HTML 아티팩트를 기본 코딩 에이전트와 직접 대화하는 대화형 리뷰 표면으로 전환하여 AI 생성 출력과 인간의 검토 사이의 간극을 메웁니다. AI 지원 개발의 안전성과 생산성을 향상시키는 것을 목표로 하는 진정한 오픈소스 소프트웨어 프로젝트입니다.

SUMMARY: Plannotator는 오픈소스, 로컬 실행 브라우저(및 터미널) UI로, AI 코딩 에이전트(Claude Code, Codex, Copilot CLI, Gemini 등)가 생성한 계획, 사양, 코드 diff 및 HTML 아티팩트에 주석을 달 수 있습니다. 주석은 구조화된 피드백으로 에이전트에 다시 전송되어 인간이 개입하는 리뷰 단계를 가능하게 합니다. Git/GitHub/GitLab을 지원하고, VS Code, Obsidian, Bear와 통합되며, 암호화된 링크 공유를 제공합니다. 설치는 원라인 스크립트로 에이전트를 자동 감지합니다. 모든 데이터는 명시적으로 공유하지 않는 한 로컬에 유지됩니다.

TITLE: Plannotator – AI 코딩 에이전트용 인터랙티브 주석 및 리뷰 UI