critique

構文強調表示、分割ビュー、単語単位の差分で Git の差分を確認できます。ターミナル UI または Web プレビューを使って、セッション中に変更されたコードをユーザーに表示できます。

前提条件

Critique には Bun が必要です（Node.js では動作しません）。

# Run directly (no install needed)
bunx critique

# Or install globally
bun install -g critique

基本コマンド

現在の変更を表示

# Unstaged changes (includes untracked files)
critique

# Staged changes only
critique --staged

# Watch mode - auto-refresh on file changes
critique --watch

コミットを表示

# Last commit
critique HEAD

# Specific commit
critique --commit HEAD~1
critique --commit abc1234

# Combined changes from last N commits
critique HEAD~3 HEAD

ブランチを比較（PR 形式）

# What feature-branch added vs main
critique main feature-branch

# What current branch added vs main
critique main HEAD

ファイルを絞り込む

# Filter by glob pattern
critique --filter "src/**/*.ts"
critique --filter "src/**/*.ts" --filter "lib/**/*.js"

Web プレビュー

ブラウザーで表示できる HTML プレビューを生成します。共有や詳細なレビューに最適です。

# Generate web preview
critique --web

# Generate and open in browser
critique --web --open

# Web preview for commits
critique HEAD --web --open
critique main HEAD --web --open

Web プレビューでは、次の機能を利用できます。

• 完全な構文強調表示
• 変更前と変更後を並べた分割ビュー
• 共有可能な HTML 出力
• 大規模な差分に適しています

AI によるレビュー

コード変更の AI による説明を生成します。AI が生成した変更のレビューに最適です。

# Review unstaged changes (uses OpenCode by default)
critique review

# Use Claude Code as the AI backend
critique review --agent claude

# Review specific commits
critique review HEAD
critique review --commit HEAD~1

# Review branch diff (like a PR)
critique review main HEAD

# Include session context for better explanations
critique review --agent claude --session <session-id>

# Generate web preview of AI review
critique review --web
critique review --web --open

AI レビューの機能：

• ハンクを論理的な読み順に並べ替えます
• 大きなハンクを、理解しやすいサイズに分割します
• 図や表を使って変更を説明します
• ファイルをまたいで関連する変更をグループ化します

インテグレーション

Git Difftool

デフォルトの git difftool として設定します。

git config --global diff.tool critique
git config --global difftool.critique.cmd 'critique difftool "$LOCAL" "$REMOTE"'

その後、次を実行します：git difftool HEAD~1

Lazygit

~/.config/lazygit/config.yml に追加します。

git:
  paging:
    pager: critique --stdin

Claude Code から実行する

TUI は Bash ツール内で実行されるため（非表示または折りたたまれます）、次のいずれかの方法を使用してください。

オプション 1：分割ペイン（macOS の iTerm2、推奨）

完了時に自動で閉じる分割ペインで critique を開きます。

# Horizontal split (top/bottom)
/path/to/skills/critique/scripts/open-critique-pane.sh /path/to/repo -h

# Vertical split (side by side)
/path/to/skills/critique/scripts/open-critique-pane.sh /path/to/repo -v

オプション 2：新しいターミナルタブ（macOS の iTerm2）

新しいタブで critique を開きます。

/path/to/skills/critique/scripts/open-critique.sh /path/to/repo

オプション 3：Web プレビュー（クロスプラットフォーム）

ブラウザーで開きます。どの環境でも動作します。

bunx critique --web --open

Claude の作業後におすすめの使い方

Claude による変更後、ユーザーから変更内容を確認したいと言われた場合：

1. 新しいターミナルタブ（macOS）：osascript を使って iTerm で critique を開きます
2. Web プレビュー：critique --web --open を実行してブラウザーで表示します
3. AI による説明付きレビュー：critique review --agent claude --web --open を実行します
4. 作業開始時点と比較：critique HEAD~N HEAD --web --open を実行します

ナビゲーションキー（ターミナル UI）

キー	操作
j/k or ↓/↑	行を移動
h/l or ←/→	ファイルを切り替え
Tab	分割ビューと統合ビューを切り替え
q	終了
?	ヘルプ