差分モード
すべてのレビューは1つの質問に答える必要があります: 何が変わったか? CLI は4つの差分モードをサポートしており、それぞれ異なる情報源を持ちます。| モード | 差分のソース | ファイルをインライン化? | 使用タイミング |
|---|---|---|---|
| 作業ツリー（デフォルト） | 作業ディレクトリ内のコミットされていない変更 | はい | 開発中、ステージング前。 |
ステージ済み（--staged） | git diff --cached | はい | コミット直前 — git commit と同じスコープ。 |
ブランチ（--branch <base>） | base..HEAD のコミット済み差分 | いいえ | ブランチ全体のマージ前レビュー。 |
コミット（--commit <sha>） | 単一コミットによって導入された差分 | いいえ | 1つのコミットの監査、チェリーピックレビュー。 |
レビューモード
3つの出力スタイル、同じ基本的なレビュー。- インタラクティブ（デフォルト）— ファイルを一覧表示し、問題を展開し、プレビューで1つずつ修正を適用する TUI。ターミナルで作業する自然な方法。
- 自動修正（
--fix）— 単一の確認で、修正可能な問題を全て一度に適用します。ルールを信頼してバッチ適用したい場合に使用。 - プロンプトのみ（
--prompt-only）— AIエージェントが解析して行動するために設計された最小限の構造化テキスト。エージェントループで--fail-onと組み合わせて、レビューがクリーンになったときにループがきれいに終了するようにします。
--format json または --format markdown も使用できます。
認証モード
マシンごとに1つ選択します。CLI は利用可能なものを自動検出します。- トライアル — 認証なし。1日5回のレビュー。「一度試す」のに最適。
- 個人ログイン（
kodus auth login）— 個人アカウント。トークンは自動更新。 - チームキー（
kodus auth team-key --key kodus_xxxxx）— ダッシュボードで生成される、チーム用の共有キー。AIエージェントやインタラクティブなログインを避けたい場所に推奨。 - CI/CD トークン（
kodus auth token）— パイプライン用の長期トークン。ログイン済みのマシンから生成し、KODUS_TOKEN経由で使用。
Kody Rules
Kody Rule は、Kodus レビュアーがすべてのレビュー中に適用する構造化ルールで、リポジトリにスコープされるかチームにグローバルに適用されます。kodus rules create|update|view を使って CLI から管理します。CLI はルールをバージョン管理に置きたい場合（スクリプトから生成し、リポジトリにチェックインし、プロビジョニング時に再適用する）に便利です。
リポジトリ設定
Kodus の各リポジトリには、レビューの動作を管理する設定があります: 無視するファイル、ベースブランチのパターン、タイトルフィルター、機能トグル。これらは Kodus バックエンドに存在し、リポジトリがレビューされる場所（ウェブ PR、CLI レビュー、エージェントループ）でミラーリングされます。 CLI から:kodus config repo と kodus config remote は同じコマンドグループのエイリアスです。
集中管理設定
通常、各リポジトリの設定は Kodus に存在します。集中管理設定を使用すると、チームはそれらの設定を単一の信頼できるソース git リポジトリに保存できます — すべての変更がそのリポジトリへのプルリクエストになり、レビュー設定自体のレビューとバージョン履歴が得られます。 有効化、同期、または状態の確認:Decision Memory
Decision Memory は、AIエージェントの作業の背後にある推論を永続化する Kodus の方法です — 差分だけでなく「なぜ」も。 有効にすると、Kodus は Claude Code、Cursor、または Codex に、ターン完了イベントごとに発火して構造化された決定をキャプチャするフックをインストールします:kodus decisions promote）。これにより、そのモジュールの将来の作業が蓄積されたコンテキストから始まります。
完全なウォークスルー: Decision Memory。
ビジネス検証
kodus review が「このコードは良いか?」を問うのに対し、kodus pr business-validation は「この差分は実際にタスクが指示したことを行っているか?」を問います。Linear/Jira/URL ベースのタスクと差分ソース（作業ツリー、ステージ済み、ブランチ、コミット）を指定すると、タスクの受け入れ基準に対して実装をチェックします。
AI エージェント出力（--prompt-only と --agent）
2つの関連するフラグ、異なる役割。
--prompt-only— 出力は AI エージェントが解析して行動するために最適化されています。レビュースタイルの出力を生成するコマンド（review、pr suggestions）にのみ機能します。--agent— 任意のコマンドで決定論的な機械可読出力を強制するグローバルフラグ。スクリプトやエージェントが CLI 出力を解析する場合に使用し、厳密なフォーマット要件には--format jsonと組み合わせます。
--prompt-only だけで十分です。ハーネスやツール呼び出しループから CLI を操作する場合に --agent を使用します。
次のステップ
コマンドリファレンス
完全なコマンド + フラグ一覧。
AI エージェント
コーディングエージェントとのレビュー・修正ループを構築。
Decision Memory
ブランチをまたいでエージェントの決定をキャプチャして昇格。
トラブルシューティング
一般的なエラーと終了コード。