tomasz-tomczyk/crit

Your feedback loop with the agent

Crit 的功能

Crit 是一個本地的單一二進位工具，讓你 檢閱 AI 代理產生的任何文字輸出——計畫、程式碼差異，甚至是執行中的 Web UI——並 直接在上面留言。這些留言會儲存在本機，並可傳回給代理讓它修正問題，形成快速的「檢閱‑修正」迴圈。

核心工作流程

  1. 執行工具 – crit 會自動偵測 Git 倉庫中變更的檔案，或是你指定的 markdown 檔、HTML 頁面，或即時的 Web 伺服器（crit http://localhost:3000）。
  2. 檢閱 UI – UI 會顯示檔案並提供語法突顯、分割或合併差異，點擊行號即可加入行內評論（單行或範圍）。
  3. 將回饋傳給代理 – 當評論被標記為「立即傳送」時，Crit 會把評論、其上下文與檔案位置傳給已設定的 AI 代理（Claude、Aider、Cursor 等）。代理的回應（或編輯後的檔案）會被擷取並內嵌顯示。
  4. 重複迭代 – 代理編輯檔案，Crit 監測變更、更新差異，你持續重複直到檢閱通過。

重點特色

  • 自適應 UI：支援 markdown、程式碼差異、靜態 HTML 或即時 Web 應用（透過代理）。
  • 回合差異：每次代理編輯後都能精確看到變更內容。
  • 程式化評論：代理可透過 crit comment … 加入評論，無需開啟瀏覽器。
  • 分享檢閱：產生公開 URL（或 QR Code）讓其他人檢視或加入評論；亦可使用 crit-web 自行託管。
  • GitHub PR 同步：將既有 PR 評論拉入 Crit 檢閱，並把新評論推回 PR（需 GitHub CLI）。
  • 分支隔離：每個 Git 分支都有獨立的檢閱檔，存於 ~/.crit/reviews/ 下。
  • 即時模式：代理開發伺服器，轉發 Cookie，讓你在開發時即時檢閱 UI。
  • 可設定：透過全域 (~/.crit.config.json) 與專案 (.crit.config.json) JSON 檔設定；許多旗標也可用環境變數設定。

目標使用者

  • 讓 LLM（Claude、Cursor、Aider 等）撰寫程式碼或計畫，且需要 人工迴圈 檢閱的開發者。
  • 想要輕量、本地化的 AI 產生變更檢閱替代方案的團隊。
  • 任何構建 AI 助手工作流程，且希望有 視覺化、評論驅動的回饋管道，不必離開終端機的人。

安裝與快速上手

# Homebrew (macOS/Linux)
br ew install crit
# 或透過 Go、Nix、Windows 二進位，或直接下載

然後將你的代理整合進去（例如 claude plugin marketplace add tomasz-tomczyk/crit），在代理中呼叫 /crit 指令，或手動執行 crit。

簡而言之：Crit 是一個本地執行的檢閱 UI，橋接人類回饋與 AI 代理，將純文字輸出轉變為互動、評論驅動的工作流程。