tomasz-tomczyk/crit

Review AI coding agents' plans, diffs and running apps in the browser. Local-first, works with any agent.

Crit – 대화형 리뷰 UI for AI 지원 코딩

What it is – 단일 바이너리로 로컬에서 실행되는 애플리케이션으로, 사용자(및 모든 LLM 기반 코딩 에이전트)가 브라우저에서 계획, diff 또는 라이브 웹 앱을 리뷰할 수 있습니다. 원하는 줄을 클릭하고 인라인 댓글을 추가할 수 있으며, 에이전트는 해당 댓글을 읽고 코드를 수정하고 실시간으로 응답할 수 있습니다.

Why it matters – 많은 AI 코드 도구가 코드를 생성하는 반면, Crit은 피드백 루프에 초점을 맞춥니다: 모든 텍스트 출력(마크다운 계획, git diff, 정적 HTML 또는 실행 중인 개발 서버)에 대해 GitHub 스타일 리뷰를 미러링하는 UI입니다. LLM의 텍스트 출력과 인간의 줄 단위 리뷰 사이의 격차를 메우고, 편집-리뷰-반복 주기를 더 빠르고 시각적으로 만듭니다.

빠른 시작

  1. 설치 – brew install crit (또는 go install, Nix, 또는 릴리스 페이지에서 바이너리 다운로드).
  2. 에이전트 연결 – Claude Code에 Crit 플러그인 추가 (claude plugin marketplace add tomasz-tomczyk/crit) 또는 지원되는 에이전트(Cursor, GitHub Copilot, Aider, Gemini 등) 사용.
  3. 실행 – 저장소 내 터미널에서 crit 실행. 변경된 파일을 자동 감지하고 로컬 웹 UI를 엽니다. 특정 파일(crit plan.md), 실행 중인 서버(crit http://localhost:3000), 또는 정적 HTML 페이지를 대상으로 지정할 수도 있습니다.

핵심 기능

  • 적응형 UI – 마크다운 계획, git diff, 라이브 웹 앱, 정적 HTML에 대한 다양한 렌더러.
  • 라운드 간 diff – 에이전트가 파일을 수정한 후 Crit은 변경 사항의 분할 또는 통합 diff를 표시합니다.
  • 인라인 댓글 – GitHub PR 리뷰처럼 줄을 클릭하거나 범위를 드래그하여 댓글을 추가합니다.
  • 프로그래매틱 댓글 – 에이전트는 브라우저를 열지 않고 crit comment …로 댓글을 추가할 수 있습니다.
  • 스토리 모드 – 대규모 PR/브랜치의 하이레벨 챕터별 개요를 생성하여 줄 단위 리뷰 전에 컨텍스트를 제공합니다(LLM 기반, 비용 인지).
  • 라이브 모드 – 실행 중인 개발 서버를 프록시하고 리뷰 오버레이를 주입하며 세션 쿠키를 전달하여 인증된 앱이 작동하도록 합니다.
  • 공유 – 비동기 협업을 위해 리뷰를 공개 URL(crit.md 또는 자체 호스팅 대상)에 원클릭 업로드.
  • GitHub / GitLab 동기화 – PR/MR에 댓글을 가져오고 푸시하며, 승인 및 변경 요청을 완전히 지원합니다.
  • 에이전트로 보내기 – 댓글에서 “Send now”를 클릭하여 구성된 LLM(예: Claude Code)이 응답하고 선택적으로 코드를 자동 편집하도록 합니다.
  • 브랜치별 격리 – 리뷰 데이터는 ~/.crit/reviews/에 저장되며 현재 git 브랜치로 범위가 제한됩니다.
  • 제로 텔레메트리 – 숨겨진 분석 없음; 유일한 네트워크 호출은 선택적 버전 확인입니다.

일반적인 워크플로우

  1. 에이전트가 계획 또는 코드 변경을 작성합니다.
  2. /crit를 호출하거나 로컬에서 crit를 실행합니다. UI가 계획, diff 또는 라이브 앱을 표시합니다.
  3. 줄을 클릭하고 댓글을 추가하거나 “Send to agent” 버튼을 사용합니다.
  4. 에이전트가 댓글을 읽고, 허용되면 파일을 수정하고 응답합니다.
  5. 리뷰가 승인될 때까지 반복한 후, 선택적으로 crit push로 댓글을 PR/MR에 동기화합니다.

통합 지점

  • Claude Code, Cursor, GitHub Copilot, OpenCode, Aider 등 – 모두 슬래시 명령 또는 바이너리 실행으로 Crit을 호출할 수 있습니다.
  • CLI 전용 – crit comment, crit share, crit pull, crit push, crit live, crit status, crit resume, crit stats, crit cleanup.
  • 구성 – 전역(~/.crit.config.json) 및 프로젝트(.crit/config.json) JSON 파일이 라이브 모드 쿠키, 공유 대상, 기본 포지, "Send to agent"에 사용되는 agent_cmd를 제어합니다.

사용 대상

  • LLM 코딩 어시스턴트를 이미 사용하고 더 풍부한 시각적 리뷰 루프를 원하는 개발자.
  • 병합 전에 AI 생성 계획이나 코드를 리뷰해야 하는 팀.
  • 로컬 머신을 벗어나지 않고 GitHub 스타일 댓글 경험을 선호하는 개인 개발자.

제한 사항 / 참고 사항

  • 모든 코드와 리뷰 데이터는 명시적으로 공유하지 않는 한 로컬에 유지됩니다.
  • "Send to agent"는 구성된 agent_cmd를 신뢰해야 합니다. 악성 저장소 수준 실행을 방지하려면 전역 구성에서만 설정할 수 있습니다.
  • 라이브 모드는 인증이 필요한 앱의 경우 추가 쿠키 처리가 필요할 수 있습니다.

리소스

결론 – Crit은 LLM이 생성한 모든 텍스트(계획, diff 또는 실행 중인 앱)를 대화형 리뷰 표면으로 전환하는 실용적인 로컬 실행 UI로, 인간과 에이전트가 빠르게 반복 작업을 수행하면서 모든 것을 개발자 통제 하에 유지할 수 있습니다.

리소스

결론 – Crit은 LLM이 생성한 모든 텍스트(계획, diff 또는 실행 중인 앱)를 대화형 리뷰 표면으로 전환하는 실용적인 로컬 실행 UI로, 인간과 에이전트가 빠르게 반복 작업을 수행하면서 모든 것을 개발자 통제 하에 유지할 수 있습니다.

관련

  • 프로젝트
    alibaba/open-code-review

    결정론적 엔지니어링과 AI 에이전트를 결합한 AI 기반 코드 리뷰 CLI 도구로, Git diff 및 전체 파일에 대해 고정밀도, 토큰 효율적인 리뷰를 제공합니다.

  • 프로젝트
    pbakaus/agent-reviews

    GitHub 풀 리퀘스트 댓글의 트리아지, 수정, 해결을 자동화하는 CLI 및 에이전트 스킬 프레임워크로, 특히 AI 리뷰 봇이 생성하는 노이즈를 대상으로 합니다.

  • 프로젝트
    hustcer/deepseek-review

    DeepSeek Code Review는 DeepSeek LLM을 사용하여 풀 리퀘스트의 코드 변경 사항을 자동으로 검토하는 도구(GitHub Action + Nushell CLI)로, 사용자 정의 프롬프트, 모델 선택, 로컬 diff 검토를 지원합니다.

  • 프로젝트
    Kritt-ai/open-kritt

    open·kritt는 Codex, Claude Code, Grok Build 등으로 AI 에이전트를 오케스트레이션하는 오픈소스이며 자체 호스팅 가능한 플랫폼으로, 코드 리포지토리에서 사용자 정의 프롬프트 기반 보안 워크플로우를 실행합니다. 집중된 작업을 구성하고, 병렬로 Docker 컨테이너에서 실행하며, 발견 결과를 검증하고 중복 제거 및 순위 매기고, 완전한 보고서 번들을 내보냅니다. 버그 바운티 연구자와 DevSecOps를 위한 웹 UI와 헤드리스 CLI를 제공하며, 모든 모델 제공자와 호환되며 AGPL-3.0 라이선스로 배포됩니다.