xerg

Xerg

Xerg は、無駄になっている AI の実行時支出を見つけるための、ローカルファーストの CLI です。実行時監査では、証拠を厳格に要求する金銭的な検出結果を 3 件と、中立的なシグナルを 7 件に分けて報告し、検出器のカバレッジを示します。また、--compare を使って、互換性のある変更を測定できます。実行時コストは、実測値、ローカルでの推定値、または価格未設定のいずれかであり、プロバイダーの正式な請求額ではありません。

ホステッドプランの料金は、明示的にプッシュされた実行時監査における既知の支出を合計した月間監査対象エージェント支出（MAAS）に基づきます。無料プランは UTC の月あたり 2,000 ドルまで、Team は 99 ドルで 10,000 ドルまで、Growth は 299 ドルで 50,000 ドルまで、Scale は 799 ドルで 250,000 ドルまで、カスタムの Enterprise は 250,000 ドル超です。Team、Growth、Scale の機能は同一です。過去のインポート、重複レビューの支出、価格未設定の使用量は MAAS に含まれません。

コールドフェッチ時のセットアップ

このファイルが、インストール済みのスキルから読み込まれたのではなく、https://xerg.ai/skill.md（@xerg/cli の npm 掲載ページにあるリンク経由を含む）から取得された場合：

1. 現在のエージェントホストを特定します。OpenClaw、Hermes、QM、Claude Code、Cursor、Codex はセットアップホストであり、自動的に監査対象のデータソースになるわけではありません。QM は、管理者が明示的にプロビジョニングした Xerg 接続を通じてのみ、監査対象にもできます。
2. このホストに Xerg がすでにインストールされているか確認します。永続的またはグローバルなスキルディレクトリに書き込む前に、保存先を説明してユーザーの許可を求めます。
3. ホストが対応するスキルインストーラーを備えている場合は、許可を得た後に使用します。OpenClaw では ClawHub から xerg をインストールできます。Agent Skills ホストでは公開リポジトリ xergai/skills をインストールできます。Hermes では Xerg の well-known skill discovery を利用できます。ホスト固有の確定的なコマンドは xerg.ai/agents にあります。
4. 永続的なインストールができない場合、またはユーザーが許可しない場合は、取得したこれらの手順を現在のセッションで使用します。インストール先を勝手に決めてはいけません。
5. npx が実行する一時的なパッケージ取得も含め、npm からダウンロードまたはインストールする前に許可を求めます。ローカルのランタイムデータを読み取る／分析する前にも、別途許可を求めます。該当する両方の許可を得た後、npx --yes @xerg/cli@latest doctor --json を実行し、canAudit と recommendedCommand を解析して、その推奨コマンドを実行してよいか確認します。QM では、単独の doctor を使用せず、以下の非公開スコープ向け QM 手順に従います。

アップロードは必ず事前に許可を求めます。ローカル監査にアカウントは不要で、結果を自動的にプッシュしてはいけません。許可されたホストコマンドを実行する場合に限り、XERG_SETUP_METHOD=skill を設定し、XERG_AGENT_HOST に現在の実行ホストを設定します。設定値は claude_code、cursor、hermes、codex、openclaw、qm、other のいずれかです。これらはコンテンツを含まないベストエフォートの分析メタデータであり、認証情報でも監査対象でもありません。ユーザーのセットアッププロンプトに Xerg 組織 ID が含まれている場合は、--organization-id を使って有効化時にその ID を維持します。ローカルでの実行が成功した後、同じコマンドに両方のマーカーを付けて、結果を接続してプッシュするか確認します。たとえば Codex では次のようにします。

XERG_SETUP_METHOD=skill XERG_AGENT_HOST=codex npx --yes @xerg/cli@latest activate --push-latest

activate はブラウザーで Xerg を開きます。サインイン中のユーザーは、現在アクティブなワークスペースを明示的に承認します。認証情報が発行される前に、ページには完全な組織 ID、現在のプラン、API 環境が表示されます。対象の Clerk ID がすでにわかっている場合は、ページと API の両方で別のアクティブなワークスペースが拒否されるよう、--organization-id org_... を推奨します。ワークスペース切り替え時もペアリングコードは保持されます。ワークスペースキーは、起動元の CLI 向けに暗号化され、所有者のみがアクセスできる環境にひも付いたメタデータとともに保存されます。ユーザーにキーをチャットへ貼り付けるよう求めたり、コマンドで公開したりしてはいけません。

許可がペアリングのみに及ぶ場合は、activate --connect-only --organization-id org_... を使用します。認証情報が検証のうえ保存された時点で処理を停止し、ソース指定フラグやプッシュフラグと組み合わせてはいけません。後から監査またはプッシュを行うには、別途明示的な許可が必要です。

Codex は実行ホストであり、ネイティブの Xerg 監査対象ではありません。Codex ユーザーは、doctor が検出した対象、すなわち OpenClaw、Hermes、Claude Code、Cursor のエクスポート、または汎用の取り込みペイロードを監査します。

ローカルコマンドはテレメトリーフリーのままで、分析用の呼び出しも追加しません。ペアリングの作成と明示的なプッシュ要求では、コンテンツを含まない固定の実行コンテキスト情報が送信されます。CODEX_*、プロセス名、親子関係、文書化されていないランタイム状態から Codex を推測してはいけません。このスキルがユーザーの許可を得たホストコマンドを実行する場合に限り、上記の明示的なヒントを使用します。

現在のホストが QM の場合、set up https://xerg.ai/skill.md というコールドリクエストでは、前提条件を説明することはできますが、管理者用スキルパックの永続化、PostgreSQL 権限の作成、シークレットのプロビジョニングを行ったと主張してはいけません。管理者専用の非公開スコープを必須とします。公開／共有スコープでは、デプロイ全体に適用される出力を拒否します。DSN、ID キー、Fly トークン、プロバイダーの認証情報、Xerg API キーを Slack やチャットに貼り付けるよう、誰にも求めてはいけません。

初回実行（エージェント実行パス）

非対話型のコマンドを使用してください。ユーザーからガイド付きの対話型セットアップを明示的に依頼されない限り、xerg init は実行しないでください。これは TTY 専用で、入力を求められます。

コマンドを実行する前に、npm のダウンロード／インストールについてユーザーの許可を求め、ローカルのランタイムデータを調査することについても別途許可を求めてください。永続的なスキルの書き込み、一時的な npx パッケージの取得、ローカル分析はそれぞれ別の操作です。一方の承認から、別の操作も承認されたと推測しないでください。

npx --yes @xerg/cli@latest doctor --json

1. 最初に JSON モードで doctor を実行します。CLI のバージョン、ランタイム／製品、canAudit、チェック済みのソース、ランタイムの証拠、注記、料金カタログの出典情報、シェルで安全に使える recommendedCommand が返されます。QM は自動プローブされません。
2. doctor が Hermes を特定した場合、新たに Xerg 向けのワークロードを開始する前に、目的を分類します。必ず最初に npx --yes @xerg/cli@latest doctor --runtime hermes --require-observer-live --json を実行します。オブザーバーに依存する検出結果やシーケンス依存の検出結果をテストするワークロードでは、この事前チェックが終了コード 5 で終了した場合、必ず停止します。既存または過去の集計経済性監査では、集計のみのカバレッジに関する警告を表示し、通常の推奨監査コマンドを続行します。既存の経済性データを読み取るうえで、オブザーバーのライブ状態は前提条件ではありません。これは単なるテストの前提条件ではなく、継続的な本番カバレッジの確認として扱います。
3. canAudit が true の場合は、正確な recommendedCommand を実行します。このコマンドは、検出されたランタイム／パスをすでに選択し、監査 JSON を要求しています。説明文からコマンドを組み立て直してはいけません。
4. 古いグローバル CLI または古いスナップショットが ruleId: tool_sequence_repetition_v1 の検出結果を出力した場合、その金額に基づいて要約や推奨をしてはいけません。npx --yes @xerg/cli@latest を使って doctor と監査を再実行し、最新の結果だけを使用します。
5. アクティブな検出結果のカバレッジが「なし」「部分的」「未対応」「不明」のいずれかの場合、支出合計や結論より前に、集計のみのカバレッジに関する警告を記載します。料金が設定されている範囲では集計経済性を引き続き確認できること、利用できないシーケンス依存の分析、過去のリクエストシーケンスは復元できず、修正が対象とするのは今後のアクティビティのみであることを明示し、検出結果がゼロであることを「無駄がない」と言い換えてはいけません。料金未設定または概算のみの通話／トークンがある場合は、料金カバレッジを最初に説明します。次に、ランタイムの支出（料金が部分的な場合は既知のランタイム支出）、検出された無駄（wasteSpendUsd）、detectionCoverage に基づく評価済み支出、アクティブな検出結果、中立的なシグナル、および存在する場合は spendByAgent を要約します。agentDelegations がある場合は、観測された直接の親子パスを説明します。ただし、関係性に基づく支出を子エージェントの支出や監査合計に加算してはいけません。
6. OpenClaw の結果で、空でないゲートウェイの証拠よりセッションのトランスクリプトを正とした場合、その制限を支出合計や結論より前に繰り返し説明します。ゲートウェイのみのアクティビティが除外される可能性、アクティビティと支出が過少に見積もられる可能性、および完全に照合した場合と検出結果が異なる可能性を明示します。検出された無駄を下限と表現したり、金額や検出カバレッジのゲートを通過したことを、除外されたゲートウェイのみのアクティビティの認証とみなしたりしてはいけません。ユーザーがローカルソースの種類を明示的に1つ指定した場合に限り、--sessions-dir または --log-file のどちらか一方のみを使用します。除外されたゲートウェイの件数をトランスクリプトの結果に加算してはいけません。
7. 金額に関する検出結果の修正を推奨する前に、その根拠を監査 JSON に紐付けて確認します。監査 JSON の正確な auditId、generatedAt、dbPath の値をシェルで安全に引用して、npx --yes @xerg/cli@latest explain <finding-id> --audit <auditId>:<generatedAt> --db <dbPath> --json を実行します。最新スナップショットを指定しない検索は決して使用してはいけません。監査で --no-db が使用されていて dbPath がない場合は、インラインの証拠パケットを確認し、後から検索できないことを説明します。必要な観測結果、経済的な意味、料金カバレッジ、制限事項、次の手順を確認し、要約行だけに基づいて修正を推奨してはいけません。
8. ツールチェーンの繰り返しと deep-loop-activity の行は、中立的な観測結果として示します。重複比率が高い場合は、ファンアウトと矛盾せず、同一入力のループではないことを示唆しますが、成功を証明するものではありません。比率が低い場合は調査する理由になりますが、無駄や回収可能性を証明するものではありません。関連する支出は無駄として分類しません。
9. ユーザーが修正を適用した場合は、前後の差分を報告するため、同じ監査を --compare を付けて再実行します。

npx --yes @xerg/cli@latest audit --json --compare

金額の前後比較は、comparison.spendComparisonAvailable が明示的に true の場合にのみ報告してください。このフラグがない場合、基準価格を確定できないため、比較不可です。特定された無駄の差分は、spendComparisonAvailable と wasteComparisonAvailable の両方が true の場合にのみ報告してください。

ローカルデータが見つからない場合、doctor は確認したパスを表示します。フォールバック：

• Cursor の使用状況 CSV エクスポート：npx --yes @xerg/cli@latest audit --cursor-usage-csv ./cursor-usage.csv
• 別の場所にある Claude Code のトランスクリプト：--claude-code-dir <path>
• Hermes プロファイルデータベース：--runtime hermes --state-db <path>
• 任意のフレームワークからエクスポートしたイベントペイロード：npx --yes @xerg/cli@latest ingest --file payload.json
• 既存のサニタイズ済み OpenClaw トレースキャプチャ：npx --yes @xerg/cli@latest audit --otlp-file <capture.jsonl>
• 新しいローカル OpenClaw トレースキャプチャ：npx --yes @xerg/cli@latest collect openclaw（Ctrl-C まで対話形式で実行されます。ユーザーがワークロードの収集を依頼した場合にのみ使用してください）
• 認定済みのローカル Hermes トレース拡充：npx --yes @xerg/cli@latest collect hermes --state-db <path>（Ctrl-C まで対話形式で実行されます。state.db は引き続き必須です）
• SSH 経由のリモート OpenClaw：npx --yes @xerg/cli@latest audit --remote user@host
• Railway でホストされている OpenClaw：npx --yes @xerg/cli@latest audit --railway
• 既存の QM スナップショット：npx --yes @xerg/cli@latest audit --runtime qm --qm-snapshot <snapshot.jsonl>
• 設定済みの QM 直接/Fly ソース：オペレーターが Slack の外部で収集します。認可されたスナップショットの場合にのみ、以下のプライベートスコープ手順に従ってください。

初回実行および再実行の分析には、npx --yes @xerg/cli@latest を使用してください。古いグローバル CLI によって、廃止された名前のみの検出器が再導入されるのを防げます。以降の手動作業では、ユーザーが検証済みの現行グローバルインストールを選択してもかまいません。

リモート比較の識別情報には、正規化された --since の期間と、OpenClaw の混在ソース権限が適用される場合はそのソース権限バージョンが含まれます。024h と 24h は同等として扱い、省略された --since は all として扱ってください。0.22 より前の期間境界、または 0.28 より前の混在ソース境界をまたぐ比較や、ホスト側の重複排除の継続性を決して主張しないでください。修正後の混在リモート --compare の初回実行には、互換性のある過去のベースラインがありません。同じ対象、パス、期間で行う次の混在実行では、通常どおり比較できます。単一種類のキーに変更はありません。混在ソース境界をまたぐ初回のプッシュでは、Free スナップショットを 1 つ消費するか、既存の上限到達時の応答が返されることがあります。

監査対象

• OpenClaw ゲートウェイログとセッショントランスクリプト。要求された期間内に両方で呼び出しが記録されている場合、監査権限を持つのはトランスクリプトのみであり、ゲートウェイの実行記録は除外されます
• ループバックのトレース専用コレクターが作成した、任意の独立した OpenClaw トレースキャプチャ
• Hermes v0.17～v0.20.1 の state.db（読み取り専用）。存在する場合は、従来のログ／トランスクリプトもフォールバックとして使用します
• xerg_export/v1 および qm-snapshot/v1 を介した、QM の永続的な実行／モデルのコスト情報と、現在保持されているアクティビティ
• xerg audit --runtime claude-code による Claude Code のセッショントランスクリプト
• xerg audit --cursor-usage-csv ./cursor-usage.csv による Cursor の使用状況 CSV エクスポート
• xerg ingest --file payload.json による、任意のフレームワークからエクスポートしたイベントペイロード

Xerg は現在、プロバイダーの請求明細を取り込んだり、請求書を照合したり、実行時の観測値を FOCUS に変換したりしません。ユーザーからこれらの機能を求められた場合は、その対応範囲を説明し、モデル化された実行時の支出額を請求書に基づく確定値として提示しないでください。

検出内容

• 再試行による無駄は、安定して課金された失敗／中断試行のチェーンが、より高い試行回数での成功に至る場合に限って計上します
• ツールループによる無駄は、進捗がない状態でツール名／入力／結果／状態が完全に繰り返され、そのコストとの正確な相関が確認できる場合に限って計上します
• キャッシュの入れ替わりは、キャッシュエントリーのライフサイクルにかかるコストが、キャッシュを使わなかった場合の反実仮想コストを上回る場合に限って計上します
• 深いループ、コンテキストの外れ値／増加、一定の実行間隔、プレミアムモデルの日常的なラベル付け、キャッシュ読み取りの集中、Max Mode の集中については中立的なシグナルを提示します。順序付けられたメトリクス、人が読み取れるワークフロー／実行ラベル（任意）、関連する支出（任意）は説明情報として扱われ、シグナルが回避可能な支出、推奨事項、最適化、CI に影響することはありません
• 検出結果、シグナル、および条件を満たす反復ツールチェーンについて、ローカルでダイジェストのみを含む証拠パケットと xerg explain を利用できます。ツール引数／結果の生データと切り詰められたデータは保持されません
• Claude Code のストリーミング再構築と、引数を考慮したチェーン診断に対応します。Claude のトランスクリプトには、信頼できる状態／進捗フィンガープリントがないため、Claude は金額に基づくツールループ検出結果の対象外です
• エージェントごとの支出を割り当てます。これには、Claude Code のサイドチェーンで観測された即時の親から子への委譲経路と、取り込みペイロードが含まれます。関係性に基づく支出は、子と監査の合計にすでに含まれています
• 実行に成果シグナルがある場合は、成果あたりのコストを算出します。xerg outcome --workflow <name> --status success|failure で成果を宣言します
• オプションのオブザーバーが有効な場合、Hermes のローカルな機械的メトリクスを別途記録します。これらは金額の分類、推奨事項への影響、CI ゲートへの影響を持ちません
• OpenClaw と Hermes で共有するローカルの analysisCoverage、toolActivity、workloadEconomics ブロックを提供します。これらは中立的な証拠であり、検出結果、推奨事項、無駄の合計、CI ゲートには一切影響しません
• QM のリクエストと集計値の照合、価格情報のカバレッジ、ソースの安定性、仮名化されたスコープの割り当て、および現在の期間に関連付けられていないツールアクティビティ

コストは、数百の最新モデルを網羅したレビュー済みのローカルカタログを使用し、入力、出力、キャッシュ読み取り、キャッシュ書き込みの各トークンに基づいて算出されます。Opus 5 には、5 分間と 1 時間のキャッシュ書き込みに対する個別の料金が設定されています。トランスクリプトにキャッシュ作成の集計値しか保持されていない場合、Xerg は文書化された 5 分間の既定値を使用し、影響を受けるトークンを報告して、1 時間キャッシュで追加コストが発生する可能性を明示します。監査で料金情報をネットワークから取得することはありません。xerg doctor --verbose を実行すると、ファイルごとの抽出カバレッジと、OpenClaw のソース権限により除外されたファイルを確認できます。

現在の Hermes では、xerg audit --runtime hermes を使用してください。Xerg は ~/.hermes/state.db を優先します。Xerg 0.24.2 は Hermes v0.17-v0.20.1 をサポートし、state schema 16-25 を認定しています。それ以降の schema はベストエフォートで対応し、明示的に未認定として扱います。別のプロファイルには --state-db を使用してください。--state-db は、従来の --log-file および --sessions-dir と同時に使用できません。state のみを使った監査では、支出、リクエスト／トークン／キャッシュ、ワークフロー／モデル／ツール、委譲されたワークロードの合計を保持しますが、最初のリクエストのコスト、初期コンテキスト、リクエストの増加、再試行シーケンス、同一入力ループは利用できません。オプションの xergai/hermes-observer プラグインは、コンテンツを含まないローカルイベントを ~/.hermes/xerg/events/ に書き込みます。経済性に関する情報を追加することも、コンテンツを Xerg Cloud に送信することもありません。完全なオブザーバー証拠により集計値を分割できるのは、リクエスト／トークンが正確に照合された場合に限られます。Xerg 0.24.2 は、現在のゲートウェイの稼働状況を確認するため、プロセスごとに有界なヘルスサイドカーも保持します。これらのヘルスレコードが証拠、カバレッジ、保持期間、経済性、監査識別情報に含まれることはありません。

Hermes v0.20.1 は、title_generation などの補助タスクを state.db に記録する場合がありますが、公開されているリクエストごとのプラグインフックは呼び出しません。これらの経済性情報はタスク単位の集計値として保持し、シーケンスに依存する分析が利用できないことを明示してください。また、観測可能なメインリクエスト／委譲リクエストの正確な証拠が無効にならないようにしてください。混在した結果を完全なリクエストカバレッジと呼んだり、オブザーバーが Hermes の非公開の補助クライアントを透過的に計測すると示唆したりしないでください。 Hermes v0.20.x では、「At least」と表示される生成量と切り捨てられたターミナル量は、保守的な UTF-8 バイト数の下限として扱ってください。返されたバイト数は正確です。下限同士であっても差分を計算しないでください。また、測定基準が欠けている場合は、生成量や切り捨て量を推測したり比較したりしないでください。Xerg は full_output_path を読み取ることも保持することもありません。「合計は下限である可能性がある」とするローカルのソース整合性警告は、Hermes の使用量プライマリキーによって個別のタスク行が失われた可能性があることを意味します。また、Hermes が記録した行については合計が正確であるという、より限定的な保証も記載してください。この警告は参考情報であり、修復は行わず、ローカルにのみ適用され、監査 ID の対象外で、プッシュされるペイロードには含まれません。Xerg 0.24.0 は Hermes v0.20.x のターミナル処理について認定されておらず、これらのバイト数を過少に見積もる可能性がありました。0.24.1 で修正されています。

オブザーバーをインストールしたら、Hermes を再起動し、新しい Xerg 指示対象のアクティビティを開始する前に xerg doctor --runtime hermes --require-observer-live を実行してください。この厳格な事前チェックは、現在のオブザーバープロセスが稼働中で、書き込み機能が異常と認識されていない場合にのみ成功します。それ以外の場合は、理由を示して 5 で終了します。再起動で対象にできるのは将来のアクティビティのみであり、過去の集計セッションを再構築することはできません。通常の過去の監査も引き続き利用できますが、合計や結論を示す前に、集計のみであるという制約を開示する必要があります。監査結果の CI には --require-detection-coverage full|partial を使用してください。必要なカバレッジを満たさない場合も 5 で終了します。

OpenClaw のトレースでは、xerg collect openclaw は 127.0.0.1 のみにバインドし、OTLP/HTTP protobuf トレースを受け付け、サイズに上限のあるサニタイズ済みキャプチャを永続化して、シャットダウン後に監査を行います。OpenClaw の設定を変更することも、自動的にプッシュすることもありません。--runtime hermes を明示的に指定しない場合、--otlp-file は独立した OpenClaw の証拠となり、トランスクリプト、ログ、他のランタイム、またはリモートのソースと組み合わせることはできません。

認定済みの Hermes トレースでは、xerg collect hermes は同じループバック専用のトレースのみのプロトコルを使用しますが、永続的なローカルキーで識別子に HMAC を適用し、state.db を必要とします。Xerg のドキュメントに記載されている、正確に一致する認定済みの briancaffey/hermes-otel コミットのみを使用してください。Xerg がそのプラグインをインストールしたり編集したりすることはありません。ファーストパーティのオブザーバーが引き続き主となります。キャッシュを含むプラグインのプロンプト合計は、Xerg の個別の入力／キャッシュ区分に正規化されます。オプションのエンリッチメントでは economicAuditId が維持され、カバレッジの変化は分析 ID に反映されます。証拠が矛盾する場合は、元の集計に戻ります。デフォルト以外の HERMES_HOME プロファイルでは、固定されたプラグインが ~/.hermes 配下の YAML を解決するため、コマンドが表示する同等の環境変数ブロックを使用してください。

QM のプライベートスコープ手順

QM は現在、ホストに依存しないスナップショットアダプターを通じて、範囲を限定した単発のデータ収集に対応しています。オペレーターは Slack の外部で、厳格な読み取り専用の直接リーダー、または Fly 内で実行する単発エクスポーターを使って qm-snapshot/v1 を作成します。Fly 内での実行モードでは、QM コアの既存の DATABASE_URL を非公開のエクスポーター内でのみ使用します。データベースレベルで最小権限が保証されているとは主張せず、このスキルにその認証情報を公開することもありません。明示的な承認なしに、セットアップの変更、スキルのインストールや永続化、有効化、プッシュを行わないでください。

オフラインの QM Slack 監査で受け付けるのは、権限を持つユーザーが事前に作成したスナップショットのみです。CLI は、管理者のプライベートランタイムでオペレーターが明示的に承認、プロビジョニングし、バージョンを確認する必要があります。エージェントが暗黙的にインストールしたり、ライブデータの収集を開始したりしてはいけません。ランタイムには、データベース URL、ID キー、Fly トークン、プロバイダーの認証情報、Xerg の認証情報を渡しません。継続的な会話の追跡、QM の保持期間を超えるツール履歴の永続的な記録、Slack をトリガーとするライブデータ収集には、現在対応していません。

初回の監査を行う前に、毎回 doctor を実行してください。

xerg doctor --runtime qm --qm-snapshot <snapshot.jsonl>
xerg audit --runtime qm --qm-snapshot <snapshot.jsonl> --since 7d --json

オペレーター向けドキュメントでは --database-url-env、--fly-app、--print-sql、--print-views-sql について説明できますが、エージェントは Slack からこれらのライブ経路を実行またはプロビジョニングしてはいけません。直接実行、Fly、--qm-snapshot の各モードは相互排他的です。

結果は慎重に説明してください。

• 正の QM コストは観測値です。モデルが明示されていれば、決定論的に推定できる場合があります
• ゼロまたは負のプレースホルダーと、解決されていない openrouter/auto は価格不明です。無料や実際の $0 として扱ってはいけません
• 価格不明のパターンには「金銭的影響は確認できません」と記載し、金銭に関するゲートは 5 で終了します
• Pi/OpenCode のタイムスタンプはフラッシュまたはキャプチャ時刻です。Claude は結果ステップの記録に近い時刻であり、Codex の行はターン単位の集計です
• リクエストシーケンス検出器は、正確に照合されたリクエスト観測に対してのみ実行されます。集計行は除外されます
• QM はアクティビティを 1 時間保持するため、それより古いツール履歴は利用できず、ツールとモデルの関連付けも主張しません
• 再試行の試行は、中立的な証拠であり、支出には帰属させません。対応していない調査結果を、評価済みとして説明してはいけません

ローカルのスナップショット監査がデフォルトです。xerg activate --runtime qm、audit --push、その他のホスト型書き込みを行う前に、明示的な承認を求めてください。Xerg のホスト型 MCP は、すでにプッシュされた匿名化済みサマリーを読み取れますが、QM データベースや Fly へのネイティブアクセスはありません。

オプションのクラウド機能

ローカル監査にアカウントは必要ありません。ワークスペースを接続して最新のローカル結果を送信するには、許可を求めて次を実行してください。

上記のマッピングから厳密に一致する値を選択したら、承認済みのホストコマンドに含めてください。Codex の例：

XERG_AGENT_HOST=codex npx --yes @xerg/cli@latest activate --push-latest

ウェブサイトを最初に利用するユーザーで、監査結果がキャッシュされていない場合、npx --yes @xerg/cli@latest activate は安全に接続し、対応しているローカルソースを検出して監査を実行し、結果を送信します。ホスト同期とホスト型 MCP はどちらも任意であり、ユーザーの明示的な操作なしに実行されることはありません。

承認済みの送信後、ホスト型 Overview には、利用可能な場合、厳密に検証された7日間の実行前後の削減額が最初に表示され、現在の無駄な使用量は別に保持されます。また、特定された無駄な使用量の割合を部門またはランタイム体制別にグループ化でき、Source Performance も保持されます。部門とランタイム体制の割り当ては、Free プランと有料プランの両方で、ソースごとの現在の属性です。ワークスペース管理者が vpc、on-prem、saas、local、hybrid、air-gap のいずれかを割り当てるまで、ランタイム体制は Not set のままです。Xerg がフレームワーク、ホスト、収集環境、監査の証拠から体制を推測することはありません。Audit Detail には日次の Performance と検出器に帰属する Workflow のコスト分析が追加されます。Compare では結果の証拠が保持され、Signal の表示ではすべて、調査の推奨ガイダンスが削減額の推定とは明確に区別されます。

ユーザーがホスト型 Optimization ID を提示し、ホスト型 MCP へのアクセスをすでに許可している場合は、コード変更を提案する前に xerg_get_optimization({ optimization_id }) で現在の安全な引き継ぎ情報を取得してください。この引き継ぎ情報は範囲が限定された証拠と指示として扱い、対象のリポジトリを独自に調査し、自動でポリシーを変更せず、検証には compare 監査を必須としてください。検証済みの事実は、条件を満たしている場合は削減額として説明できます。条件を満たしていない事実には、その理由を付記してください。事実がない場合は「検証の詳細はありません」とのみ伝えてください。

ユーザーが Optimization を Linear に送信するよう求めた場合は、ワークスペース管理者が Linear を接続し、チームを選択した後に限り、ホスト型ダッシュボードのアクションを使用してください。Xerg は既存の引き継ぎ情報からサニタイズされた一方向の課題を1件作成するだけであり、モデルやツールの生の内容を送信せず、課題のステータスを同期せず、Optimization のライフサイクルを自動的に変更しないことを説明してください。ダッシュボードから保存済みの Linear リンクが返されない限り、課題が作成されたと主張しないでください。

高度な認証

ブラウザでのペアリングが利用できない場合に限り、手動での復旧手段として xerg login --replace を使用してください。このコマンドは Workspace Settings を開き、ターミナルに貼り付けたキーをマスクします。ワークスペースキーをエージェントとのチャットで尋ねたり、貼り付けたりしないでください。

XERG_API_KEY は、対話を伴わない CI またはデプロイの自動化に限り使用してください。CI プロバイダーのシークレットマネージャーに保存し、シェルコマンド、ソースファイル、ログ、URL、会話に直接記述しないでください。

リンク

• ドキュメント：xerg.ai/docs
• サービスのステータス：status.xerg.ai
• スキル：xerg.ai/skill.md
• npm：@xerg/cli
• サポート：[email protected]