tomasz-tomczyk/crit

Your feedback loop with the agent

Crit ができること

Crit はローカルで単一バイナリのツールで、AI エージェントが生成したテキスト出力（プラン、コード差分、あるいは実行中の Web UI）を レビュー し、直接 コメント を付けることができます。コメントはローカルに保存され、エージェントに送り返すことで問題を修正させ、迅速な「レビュー‑修正」ループを実現します。

コアワークフロー

  1. ツールを実行 – crit は Git リポジトリ内の変更ファイルを自動検出するか、特定の markdown ファイル、HTML ページ、またはライブサーバー（crit http://localhost:3000）を指定できます。
  2. レビュー UI – UI はファイルをシンタックスハイライト付きで表示し、分割または統合 diff を提供し、行番号をクリックしてインラインコメント（単一行または範囲）を追加できます。
  3. エージェントへフィードバック送信 – コメントが「今すぐ送信」マークされたとき、Crit はコメントとそのコンテキスト、ファイル位置を設定された AI エージェント（Claude、Aider、Cursor など）に渡します。エージェントの応答（または編集されたファイル）は取得され、インラインで表示されます。
  4. イテレート – エージェントがファイルを編集し、Crit が変更を監視して diff を更新し、レビューが承認されるまで繰り返します。

ハイライト

  • マークダウン、コード差分、静的 HTML、ライブ Web アプリ（プロキシ経由） に対応した 適応 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 エージェントを橋渡しし、プレーンテキスト出力をインタラクティブでコメント駆動のワークフローに変換します。