tomasz-tomczyk/crit

Your feedback loop with the agent

Crit가 하는 일

Crit는 로컬에서 단일 바이너리로 동작하는 도구로, AI 에이전트가 생성한 텍스트 출력(계획, 코드 diff, 혹은 실행 중인 웹 UI)을 리뷰하고 직접 댓글을 달 수 있게 해줍니다. 댓글은 로컬에 저장되고 에이전트에게 다시 전송되어 문제를 수정하도록 하여 빠른 “리뷰‑수정” 루프를 만들 수 있습니다.

핵심 워크플로우

  1. 도구 실행 – crit은 Git 저장소에서 변경된 파일을 자동으로 감지하거나, 특정 markdown 파일, HTML 페이지, 혹은 실시간 웹 서버(crit http://localhost:3000)를 지정할 수 있습니다.
  2. 리뷰 UI – UI는 파일을 구문 강조와 함께 보여주고, split 혹은 unified diff를 제공하며, 라인 번호를 클릭해 인라인 댓글(단일 라인 또는 범위)을 추가할 수 있습니다.
  3. 에이전트에 피드백 전송 – 댓글에 “지금 전송” 표시를 하면 Crit는 해당 댓글, 컨텍스트, 파일 위치를 설정된 AI 에이전트(Claude, Aider, Cursor 등)에게 전달합니다. 에이전트의 응답(또는 수정된 파일)은 캡처되어 인라인으로 표시됩니다.
  4. 반복 – 에이전트가 파일을 수정하면 Crit가 변화를 감시하고 diff를 업데이트하며, 리뷰가 승인될 때까지 이 과정을 반복합니다.

주요 특징

  • 마크다운, 코드 diff, 정적 HTML, 실시간 웹 앱(프록시) 지원하는 적응형 UI.
  • 라운드‑투‑라운드 diff – 에이전트가 편집할 때마다 정확히 어떤 부분이 바뀌었는지 확인 가능.
  • 프로그래밍 방식 댓글 – crit comment … 로 에이전트가 브라우저 없이도 댓글을 추가할 수 있음.
  • 리뷰 공유 – 공개 URL(또는 QR 코드)을 생성해 다른 사람이 보기·댓글 달기 가능; crit-web으로 자체 호스팅 가능.
  • GitHub PR 동기화 – 기존 PR 댓글을 Crit 리뷰에 가져오고, 새 댓글을 PR에 푸시( GitHub CLI 필요).
  • 브랜치별 격리 – 각 Git 브랜치마다 ~/.crit/reviews/ 아래에 별도 리뷰 파일이 저장됨.
  • 실시간 모드 – 실행 중인 개발 서버를 프록시하고 쿠키를 전달해 개발 중 UI를 바로 리뷰.
  • 설정 가능 – 전역(~/.crit.config.json) 및 프로젝트(.crit.config.json) JSON 파일을 통해 설정; 많은 플래그를 환경 변수로도 지정 가능.

누가 사용할까?

  • LLM(Claude, Cursor, Aider 등)에게 코드를 작성하거나 계획을 만들게 하고 인간이 루프에 참여하는 리뷰 단계가 필요한 개발자.
  • AI가 생성한 변경 사항에 대해 가볍고 로컬에서 사용할 수 있는 PR 스타일 리뷰 대안을 찾는 팀.
  • AI 어시스턴트 기반 워크플로우를 구축하면서 시각적이고 댓글 기반 피드백 채널을 터미널을 떠나지 않고 사용하고 싶은 모든 사람.

설치 및 빠른 시작

# Homebrew (macOS/Linux)
br ew install crit
# 또는 Go, Nix, Windows 바이너리, 직접 다운로드 등으로

그 후 에이전트와 통합합니다(예: claude plugin marketplace add tomasz-tomczyk/crit). 에이전트에서 /crit 슬래시 명령을 호출하거나 직접 crit을 실행하면 됩니다.

한 줄 요약: Crit는 로컬에서 실행되는 리뷰 UI로, 인간 피드백과 AI 에이전트를 연결해 일반 텍스트 출력을 인터랙티브하고 댓글 기반의 워크플로우로 전환합니다.