はじめに

設定がわかると、
作業が進む。

「なぜこのルールが無視されるのか」から、出典ファイル、読み込みルール、次の操作へ。インスペクターと診断説明は現在英語です。このガイドでは画面と照合できるよう、操作項目の英語名を併記しています。

Sightline をインストール

macOS、Windows、Linux で Node.js 22 以降が必要です。プロジェクトのフォルダーでターミナルを開き、次のコマンドを実行すると、ブラウザーでリポジトリを検査できます。

npx --yes https://github.com/iamzwxyy/agent-sightline/releases/download/v0.3.47/agent-sightline-0.3.47.tgz ui

インスペクターはプロジェクト設定とユーザー設定をローカルで読み取ります。検査中はターミナルを開いたままにし、終了時に Ctrl+C を押してください。

繰り返し使う場合は、v0.3.47 の CLI パッケージをインストールします。

CLI パッケージをダウンロード ↓

実行時の依存関係は同梱されています。ダウンロード後は npm install -g --offline ./agent-sightline-0.3.47.tgzでオフラインインストールでき、公開パッケージ URL から直接インストールすることもできます。

npm install -g https://github.com/iamzwxyy/agent-sightline/releases/download/v0.3.47/agent-sightline-0.3.47.tgz

同梱サンプルをブラウザーで開きます。サンプルには意図的な設定エラーが含まれ、個人の設定は対象にしません。

agent-sightline demo --ui

ひとつのコマンドでサンプルを開くこともできます。

npx --yes https://github.com/iamzwxyy/agent-sightline/releases/download/v0.3.47/agent-sightline-0.3.47.tgz demo --ui

パッケージは公開の GitHub Releases と公式サイトから配布しています。npm 公開レジストリへの初回公開は準備中です。

最初のスキャン

リポジトリ内の任意のサブディレクトリでターミナルを開き、CLI を実行します。Sightline は最も近い Git ルートを探し、適用される上位ディレクトリの設定も含めます。文書化された設定の出典を検出し、確定できる問題を報告します。

相対パスの対象は、現在のディレクトリを基準に解決します。 --repo で検査の境界を指定すると、そのディレクトリを基準に対象を解決します。診断は選択した対象とクライアントに従います。別のプロジェクトで検出されたファイルには出典の状態が表示されます。診断するには、対応する対象かプロジェクトの境界を選択します。

agent-sightline

UI コマンドを実行すると、クライアントの概要と対処方法を確認できるローカルページが開きます。

agent-sightline ui

最初のターミナル要約には、読み込まれた指示の出典、実際のバイト数、条件付きの出典、切り詰めが表示されます。ブラウザーの概要で Inspect conditional loading(条件付き読み込みを確認) を選ぶと、出典を開いて信頼、承認、セッションの要件を確認できます。

上部で対象ファイルを選択します。ファイル名、パス、あいまい検索で候補を絞り、矢印キーと Enter で選択できます。パスを直接入力することもできます。macOS では ⌘K、Windows と Linux では Ctrl+K で対象の選択欄に移動します。

ひとつの指示をたどる

サイドバーでクライアントを選択すると、出典が読み込み順に並びます。ファイルを選ぶと、プレビュー、読み込みの判断、正確なバイト寄与を確認できます。同じファイルの複数行には、それぞれの判断とインポート元が保持されます。説明パネルからインポート元を開くと、宣言行に移動できます。再読み込みやブラウザーの履歴でも、ローカル版と共有用レポートで選択した読み込み箇所が保持されます。

All discovered(検出したすべての出典)には、無視されたファイルや上書きされたファイルも含まれるため、ディスク上にあってもクライアントに届かない設定を探せます。/ キーで出典パスとインポート元を検索します。たとえば shared beta.md:3 のように語を組み合わせると、特定のインポートを探せます。大文字・小文字とスラッシュの向きは区別しません。In scope(対象範囲内)が一致する出典を隠している場合は、Show all discovered(すべての出典を表示)を選ぶと表示され、フォーカスが移ります。検索を消すと結果が戻り、検索欄にフォーカスします。Tab で一覧に入り、矢印キーや Home/End で移動し、Enter で選択します。出典への移動後は、状態付きのファイル名見出しにフォーカスします。Shift+Tab で一覧に戻れます。長い一覧でも、出典への移動、再読み込み、履歴の移動後に選択行が表示されます。デスクトップの検索とフィルターはスクロールする一覧の上に配置されます。出典や指示の対応範囲のリンクは検索を解除して移動先を表示します。ブラウザーの戻る・進むでも、移動先を隠す検索は解除されます。

Claude のオンデマンド指示は、取得したモデルとコンテキストの設定から文字数の予算を決定します。切り詰められた出典には、元ファイルで最初に省略された文字の行と列が表示されます。セッションのモデルやコンテキストを確定できない場合は、上限を条件付きとして扱います。モデル変更後に更新すると、新しい読み込み範囲を確認できます。エクスポート済みレポートは、取得時の検査結果を保持します。

Read effective text(有効なテキストを読む)に切り替えると、累積された指示を確認できます。読み込み順の各出典から定義へ移動できます。Settings(設定)では解決済みの値を検索し、採用された定義と置き換えられた設定層をたどれます。

同じ説明をターミナルでも確認できます。

agent-sightline explain src/payments/refund.ts --client codex --trust trusted

対象ファイルのディレクトリを、新しいエージェントセッションの起動場所としてモデル化します。信頼セレクターはモデル化する前提を変更し、クライアントに保存された信頼設定は変更しません。

Codex プロファイルを検査

Codex を --profile review で起動する場合は、Sightline でも同じプロファイルを検査します。ユーザーの既定設定の後、プロジェクト設定の前に $CODEX_HOME/review.config.toml を読み込みます。設定を選ぶと、採用された定義と置き換えられた定義をたどれます。

agent-sightline explain src/payments/refund.ts --client codex --profile review --trust trusted

ローカルインスペクターの Codex profile 欄でも同じファイルを選べます。空欄にして適用すると基本設定に戻ります。選択は再読み込み後も保持され、レポートにも記録されます。プロファイルはユーザー設定を使うため、--no-user を指定すると対象外になります。

クライアントごとの違いを比較

Compare clients(クライアントを比較)を開くと、異なるファイルにある同じ指示段落を探せます。共通の内容や受け取るクライアントが違う内容を絞り込み、各出現箇所からクライアントと元の行に移動できます。重複する段落も、すべての出現箇所が保持されます。実際に読み込まれたテキストを並べて確認でき、出典とクライアントの対応表も表示されます。使っているクライアントを選び、Differences only(相違のみ)を有効にすると、読み込みの違いに注目できます。各状態を選ぶと、その出典とクライアントごとの理由を確認できます。

対応範囲には構造化インポートと各クライアントでの設定の役割が含まれます。複数の読み込みを含む状態を選ぶと、個々の出現箇所と出典の行を確認できます。

拡張機能の比較では、MCP、スキル、フック、権限のコマンドと定義を確認できます。有効な候補と条件付きの候補ごとに、操作と読み込み状態が表示されます。定義を選ぶと設定と出典を確認できます。

agent-sightline diff src/payments/refund.ts --clients codex,claude,copilot

選択したクライアント、内容フィルター、Differences only、展開した段落は、再読み込みや履歴の移動後も保持されます。Refresh scan(再スキャン)でも比較は保持され、Export report(レポートを出力)でオフライン閲覧や再共有用に保存できます。

行単位の比較では、選択した 2 つのクライアントの秘匿情報をマスクした有効テキストを整列します。左右のクライアントを選び、変更のない行を表示して前後関係を確認できます。Inspect sources(出典を確認)から読み込み順を開けます。行番号は表示中の有効テキストに対応します。追加と削除を示し、置換内の変更された単語や文字も強調します。絵文字と結合アクセントは分割されません。大きな置換でも行全体の強調表示を保ちます。長い比較は最初の 200 行より先まで展開できます。クライアントの組み合わせ、前後の行、展開範囲は再読み込み、更新、オフライン共有後も保持されます。

見つけたことを共有

Export report(レポートを出力)は、単一 HTML のスナップショットを作成します。開くと、クライアント、インポートの出現箇所、強調行を含む、選択した表示と出典位置が復元されます。Read effective text の表示も復元されます。オフラインのレポートを再出力して、新しい閲覧位置を共有することもできます。ビューや出典のフラグメントを含むブラウザーのリンクは、その位置を開きます。レポートには出典の探索、クライアント比較、診断が含まれます。関連する出典はクライアントと元の行にリンクします。移動すると選択した行が表示されます。再読み込みやブラウザーの戻る・進むでも、ローカル版と共有用レポートで行が保持されます。キーボードで出典をたどった後の再読み込みでも、リンク先の行が表示されます。ローカルインスペクターの Refresh scan は選択行を保持します。更新後は固定ツールバーにエラー、警告、検出範囲の要約が表示されます。Review findings(診断を確認)や Review scan scope(スキャン範囲を確認)から続けられます。長い出典を読んでいる間も、ナビゲーションと出力を利用できます。ローカルインスペクターは対象の操作欄とスキャンエラーも表示し続けます。Copy location(位置をコピー)は、ファイルに関する診断のパスと位置をコピーします。レポートはブラウザーで開いたり、チームメンバーに送ったりできます。

agent-sightline report --format html --output report.html

スナップショットでは、取得したリポジトリとホームのパス、検証済みの設定エイリアス、カスタムのエージェントルートを置き換えます。環境変数やヘッダーの値、認識したシークレットをマスクします。文章やシェルの断片に含まれる認識できないパスは残る場合があります。共有前に個人情報を確認してください。

v0.3.47 は、指示の切り詰め境界で分割された取得済みの秘匿値を隠します。影響する古いレポートは、共有前に再生成して置き換えてください。既存の出力ファイルには、取得時の内容が残っています。

v0.3.13 では、ディレクトリエイリアス、シンボリックリンクによる範囲外参照、不正または競合する宣言について、Copilot の保存済み信頼の照合を修正しました。影響する v0.3.11 の検査をやり直し、ワークスペース MCP とプロジェクト設定の状態を更新してください。

v0.3.11 では、検査範囲に使用中の Copilot 設定ディレクトリが含まれる場合の個人状態のプレビューを保護しています。この条件では、v0.3.10 が内部の config.json の状態を JSON と HTML のプレビューに含めることがありました。影響する古いレポートは共有前に確認してください。

v0.3.10 では、不正な TOML に含まれる値を指示にコピーした場合のマスク処理を修正しました。v0.3.9 では、そのファイルの環境変数の値が読み込まれた指示にも現れると、レポートに含まれることがありました。影響する古いレポートは共有前に確認してください。

英語のサンプルレポートを開く →

CI で設定エラーを検出

リポジトリ内だけを対象にすると、再現可能な CI スキャンを行えます。ビルドを失敗させる診断の重大度を設定してください。

agent-sightline ci --no-user --fail-on warn --json

終了コード 0 は、検査が完了し閾値に達しなかったことを示します。1 は診断が閾値に達したこと、2 は入力または検査のエラーを示します。ルール ID と JSON スキーマのバージョン 1.0 をスクリプト連携に利用できます。

検査の範囲を確認

Codex 0.167.2 の基本設定とプロジェクト設定のスカラー値、MCP の値、採用されたファイルは、23 件の隔離シナリオで実際の設定 API と比較しています。さらに 21 件のスクリプト化したネイティブリクエストで、AGENTS.md の正確な本文、バイト上限、override の選択、ルートマーカー、信頼、選択プロファイルの予算とフォールバックファイル名を比較しています。その他のプロファイル項目と出典の行番号は、固定版のソースとスキーマのフィクスチャーを使用しています。Codex のスキル名、正規化したファイル、利用可否、ユーザーとプロジェクトのスコープにも、ディレクトリリンクと無効化されたパスを含むネイティブ一覧との比較があります。隔離された Claude Code 2.1.322 の 98 件のシナリオでは、指示の順序、正確な読み込みテキスト、モデルとコンテキストによる文字数の予算、ルールファイルのインポート、AGENTS モード、パスごとの読み込み、保存済みの外部インポート承認を比較します。パス付きルールは起動時にインポートを展開し、その本文は一致するファイルを待ちます。セッションディレクトリ外のプロジェクトインポートには個別の保存済み承認を使い、未承認と拒否の状態を保持します。リンクされたワークツリーは共有の Git プロジェクト ID を使用します。通常の .git ディレクトリではメインのチェックアウトを選び、別置きの Git ディレクトリは独自のキーを保持します。Windows の起動エイリアスが正規パスと異なる場合は、独立したエントリーを保持します。Windows の承認キーにはスラッシュを使います。MCP のトランスポート、承認の境界、stdio のディレクトリ動作もネイティブ CLI と比較します。11 件のネイティブなローカルスコープ登録で、ディレクトリエイリアス、サブディレクトリ、Git 外のセッション、広い検査範囲、リンクされたワークツリー、別置き Git ディレクトリでの保存済みプロジェクトキーを検証します。ローカルサーバーは同名のユーザーとプロジェクトの候補を置き換えます。不正なローカル宣言では、適用可能な下位スコープの定義を保持します。19 件の隔離された権限検査では、ループバックのスクリプト API を使い、実際のツール実行、deny/ask/allow の優先順位、ワークスペースの許可を検証します。ワークスペースの信頼を明示的にモデル化するまで、ローカルの許可には Git とセッションの条件を残します。Copilot CLI 1.0.110 の設定マージ、個人エイリアス、ファイル読み込み、ワークスペース MCP の許可、共有 Claude ルールの検出は、ネイティブ設定 API と CLI の一覧に照らして検証しています。個人設定のスキーマは一部対応です。その他の Claude の機能は、実行可能なフィクスチャーを用いて公式ドキュメントの契約を検証しています。Gemini のツリー形式とフラット形式のコンテキスト読み込みには、公開版 0.68.0 の処理との実行可能な比較が 31 件あります。読み込んだテキストには出典区間とネイティブのメモリ境界を保持します。Gemini、Cursor、OpenCode V2 のアダプターは部分的な試験対応です。

インスペクターの Scan scope & rule versions(スキャン範囲とルールのバージョン)で、公式の出典リンクと各アダプターの制限を確認できます。コマンドラインの上書き、実行中セッションの切り替え、インストール済みプラグイン、リモート管理ポリシーから追加の設定が入る場合があります。

検出の既定上限は、リポジトリ内の 50,000 エントリーと、ユーザー設定ルートごとに 4,000 件の一致ファイルです。 --max-entries と --max-user-files で上限を調整できます。診断をフィルターした場合も、検出が未完了であることはインスペクターとレポートに表示されます。

スキャンはローカルで動作し、テレメトリ、モデル呼び出し、アップロードはありません。通常はリポジトリと文書化されたユーザー設定の場所を読み取ります。--no-user を指定すると、リポジトリだけが対象になります。--system で Claude の管理設定、ポリシーの追加ファイル、専用の managed-mcp.json を検査できます。ブロックされた MCP 項目から、除外元のポリシーに移動できます。無関係な外部の非公開ディレクトリツリーは探索しません。

通常の拡張機能の診断は、検出と設定を確認します。doctor --probe を明示的に実行すると、ローカルの stdio MCP プロセスを起動し、初期化してツール一覧を取得します。サーバーコードの起動には副作用が生じる場合があります。スキャンはフックのコマンドや MCP ツールを実行しません。

このコマンドをコピー

⌘C または Ctrl+C で選択したコマンドをコピーします。スマートフォンではテキストを長押ししてコピーを選びます。