preflight

---

AI ツールにオブザーバビリティが必要な理由

AI コーディングアシスタントは、セッションごとに何百もの判断を下します。何を読むか、何を編集するか、いつコマンドを実行するかなどです。しかし、その様子を確認することはできません。処理が速かったことは分かっても、_効率的_だったでしょうか？PR はマージできても、どれほどのコストがかかったでしょうか？バグは修正できても、その前にループに陥っていなかったでしょうか？

Preflight はエージェント型コーディングのオブザーバビリティを提供します。AI コーディングアシスタントが作業する際のアクション、コスト、効率を可視化します。何が起きているか、どれだけのコストがかかっているか、AI がどこで時間を無駄にしているかを正確に確認できます。

ローカルファースト設計です。 Preflight はすべてお使いのマシン上で動作し、デフォルトではデータをどこにも送信しません。localhost:7777 のライブダッシュボードで、完全にオフラインのままセッションをリアルタイムで確認できます。チーム全体の集計、アラート、セッションをまたいだ履歴などが必要になったときだけ、New Relic アカウントに接続してください。ローカルのみ、New Relic、または両方から選べます。

---

デモ

コストの内訳、効率スコア、アンチパターン、セッションのライブ追跡をご覧ください。

---

利用できる機能

可視性

• すべてのアクションを記録 — ファイルの読み取り、編集、コマンド、検索
• ライブセッションダッシュボード — 現在の状況を確認
• 履歴の傾向 — 数週間から数か月にわたるパターンを分析

コスト管理

• 米ドルでの支出追跡 — セッション、日、週ごと
• モデル別およびキャッシュの内訳 — 最もコストのかかるモデルと、コンテキストをどれだけ効率よく再利用できているかを把握
• 予算アラート — 予算超過の前に通知
• 予測 — 月間の支出ペースを予測

効率に関する分析

• 効率スコア — AI の作業がどれだけ直接的だったかに基づく、タスクごとの 0〜100 のスコア
• アンチパターンの検出 — 再読み込み、見当違いの編集、停滞したループを検出
• パーソナライズされた推奨事項 — AI ワークフローを最適化
• 週次コーチングレポート — 過去の基準値と比較した分析レポート

ダッシュボード

• ローカルダッシュボード — localhost:7777 でセッションをライブ表示。アカウントは不要です
• 構築済みの New Relic ダッシュボード 8 種類 — 数秒でデプロイできます (New Relic モード)：
  • 概要 — セッション統計、コスト概要、上位のツール
  • 個人 — 自分のデータに絞った過去 30 日間の振り返り
  • セッション詳細 — 1 つのセッションにおけるツール呼び出しを詳しく分析
  • チームビュー — 開発者間のコストと効率を集計
  • マネージャービュー — ツール呼び出しの内容を含まない、チームの概要指標
  • 導入状況とコスト — 導入の進捗、支出、MCP の利用状況、開発マネージャー向けの開発者別の成果
  • プラットフォーム比較 — Claude Code、Cursor、Windsurf などを比較
  • セキュリティ監査 — 機密ファイルへのアクセス履歴

---

クイックスタート

1. インストール

npm install -g @newrelic/preflight

Smitheryを使用していますか？ Smithery MCP レジストリから Preflight をインストールすると、MCP サーバーが設定されますが、Smithery には Claude Code のフックを書き込む機能がありません。インストール後、ターミナルで preflight install を実行するか、Preflight の設定で "allowHeadlessInstall": true（または NEW_RELIC_AI_ALLOW_HEADLESS_INSTALL=true）を設定して、Claude Code に nr_observe_install_hooks MCP ツールを呼び出すよう依頼してください。接続されているどの MCP クライアントからも呼び出せるため、このツールはデフォルトでは実行を拒否します。このフラグを有効にすると、nr_observe_health が setup_required: true を報告したときに、自動で実行するかどうかを尋ねます。その後、Claude Code を再起動してモニタリングを有効にしてください。

2. セットアップを実行する

preflight setup

ウィザードはデフォルトでローカルモードになっています。プロンプトで Enter キーを押していけば、準備完了です。Preflight が AI ツールに組み込まれ（フック＋MCP サーバー）、設定が ~/.newrelic-preflight/ に書き込まれます。1 分もかからず、アカウントも必要ありません。

GitHub Copilotを使用していますか？ ウィザードでは Copilot フックのインストールも確認されます。「はい」と答えると、Copilot CLI と VS Code Copilot Chat の両方が自動で設定されます（フック、MCP 登録、VS Code のフック二重キャプチャの修正）。これにより、Copilot でも Claude Code と同じツール呼び出しとコストのメトリクスを取得できます。preflight install --copilot を実行すれば、いつでも単独でインストールできます。詳しくはdocs/ADAPTERS.mdをご覧ください。

モードを選択してください。

モード	内容	New Relic アカウント
local (デフォルト)	すべてがローカルマシンに保持されます。ライブダッシュボードは localhost:7777 です	不要
cloud	テレメトリーを New Relic に送信します	必須
both	ローカルダッシュボードと New Relic の両方を使用します	必須

3. コーディングを開始する

AI ツールを再起動してください。フックと MCP サーバーはセッションの開始時に読み込まれます。すべてのツール呼び出しが自動的にキャプチャされます。http://localhost:7777 を開くと、セッションをリアルタイムで確認できます。

Kiroを使用していますか？ nr_observe_* クエリツールを利用するには、Preflight を Kiro Power として追加してください。インストール手順と、自動ツール呼び出しキャプチャを追加する方法については、ドキュメントをご覧ください。

Claude Codeを使用していますか？ 上記の npm インストールを省略して、代わりに Preflight をClaude Code プラグインとして追加できます。

/plugin marketplace add newrelic-experimental/preflight
/plugin install newrelic-preflight@newrelic-preflight-marketplace

その他のインストール方法

Cursor — Cursorに追加を使うと、ワンクリックのディープリンクで MCP サーバーをインストールできます。その後、フックでキャプチャするには preflight setup を実行してください。

Homebrew（macOS）：

brew tap newrelic-experimental/preflight
brew trust newrelic-experimental/preflight
brew install preflight

その後、フックでキャプチャするには preflight setup を実行してください。

---

対応ツール

Claude Code • Amazon Kiro • Amazon Q Developer CLI • Factory Droid • OpenAI Codex • opencode • Kilo Code • Pi • GitHub Copilot • GitHub Copilot SDK • GitHub Copilot app • Google Gemini CLI • Cursor • Windsurf • Google Antigravity • Zed • Continue.dev • Cline

対応範囲はプラットフォームによって異なります。組み込みのツール呼び出しをすべてキャプチャするものもあれば、Preflight 独自の MCP ツールにルーティングされた呼び出しのみを確認できるもの（Zed、Continue.dev、Cline）もあります。各プラットフォームで確認できる内容とできない内容、およびプラットフォームごとのセットアップ手順については、ADAPTERS.mdをご覧ください。

---

New Relic に接続する（任意）

ローカルモードだけでも、すべての機能を利用できます。New Relic アカウントに接続すると、次の機能を利用できます。

• 複数の開発者を対象にしたチームおよびマネージャー向けダッシュボード
• コストの急増、効率の低下、ループの停止に関するアラート
• セッションをまたいだ履歴、傾向、週次のコーチングレポート

preflight setup を再実行して cloud または both を選ぶか、対話形式を使わずに設定します。

preflight install \
  --mode cloud \
  --license-key YOUR_LICENSE_KEY \
  --account-id YOUR_ACCOUNT_ID

EU アカウントでは --eu を追加します。FedRAMP アカウントでは --fedramp を追加します。日本のアカウントでは --jp を追加します。

次に、あらかじめ用意されたダッシュボードをデプロイします。

NEW_RELIC_API_KEY=NRAK-... NEW_RELIC_ACCOUNT_ID=12345 \
  preflight deploy-dashboards --all

ライセンスキー（テレメトリの取り込み用）、アカウント ID、およびダッシュボードとアラートのデプロイに使用するユーザー API キー（NRAK-…）が必要です。アラート、他のバックエンドへの OTLP エクスポート、Terraform については、ADVANCED.md を参照してください。

deploy-dashboards を実行するまで、ダッシュボードは表示されません。 Cloud モードでは設定後すぐにテレメトリが New Relic に送信されますが、ダッシュボードは自動で作成されません。ダッシュボードの作成には、上記の別の手順が必要で、別の認証情報（ライセンスキーではなく、ユーザー API キー）が必要です。実行するまでは、確認できる UI はありません。その間は、New Relic の Query Builder で生イベントを直接クエリできます。例：

SELECT * FROM AiToolCall SINCE 1 hour ago

deploy-dashboards が正常に完了したら、New Relic アカウントの Dashboards セクションでダッシュボードを確認できます。

データ取り込みに関する注意： New Relic に送信されるテレメトリは、アカウントのデータ取り込み量に加算されます。有料プランでは、標準の取り込み料金が適用されます。NR One → Data Management → Data Ingestion で使用量を確認してください。

---

要件

必須

• Node.js v22 以降（入手するか、nvm を使用してください）
• AI コーディングツール（最も深く統合できる Claude Code を推奨）

任意

• New Relic アカウント — cloud／both モードでのみ必要です。ローカルのみで実行する場合（デフォルト）は不要です。
• ユーザー API キー（NRAK-…）— ダッシュボードとアラートのデプロイにのみ必要です

---

その他のコマンド

preflight doctor               # Run 10 diagnostic checks and print actionable fix commands
preflight validate             # Check config for syntax errors and unknown keys
preflight update               # Pull latest version, rebuild, and offer to restart a running dashboard (source installs only — npm installs: npm install -g @newrelic/preflight@latest; Homebrew installs: brew upgrade preflight)
preflight local                # List running --local dashboard processes and live --stdio MCP processes
preflight local --clean        # Kill orphaned --local processes and --stdio processes with a missing binary (prompts for confirmation)
preflight uninstall            # Remove hooks and MCP config (prompts with a summary first)
preflight uninstall --yes      # Skip the confirmation prompt (for scripts and CI)
preflight uninstall --daemon   # Remove only the background dashboard daemon

install／uninstall に --project を追加すると、変更を現在のディレクトリ内のみに適用できます。

WSL ユーザー向け： preflight setup では、使用している Claude Code の種類を尋ねられます。明示的に設定することもできます。

• --windows-cc — Windows Claude Code（デスクトップアプリ）。wsl.exe フックと Windows のパスを使用します
• --linux-cc — WSL 内で npm を使ってインストールした Linux Claude Code

---

ドキュメント

• ADVANCED.md — 設定、ダッシュボード、アラート、Terraform
• SCORECARDS.md — チームへの帰属を設定する New Relic Scorecard ルール
• ARCHITECTURE.md — データフロー、コンポーネントのリファレンス、動作モード
• ADAPTERS.md — プラットフォームごとの統合方式、セットアップ手順、既知の制限
• FLEET_DEPLOYMENT.md — 管理対象の設定と MDM を使って、多数のマシンに Claude Code プラグインを展開する方法
• TROUBLESHOOTING.md — よくあるセットアップや接続の問題と、その解決方法
• CONTRIBUTING.md — 開発、テスト、PR の提出
• SECURITY.md — セキュリティのガイドラインとベストプラクティス
• PRIVACY.md — データ収集項目とクラウド利用前のチェックリスト

---

ソースから実行する

開発やテスト、または未リリースの最新バージョンを実行する場合：

git clone https://github.com/newrelic-experimental/preflight
cd preflight
nvm use              # Switch to Node v24
npm ci               # Install dependencies from the lockfile
npm run build        # Build the server and the dashboard bundle
npm link             # Register preflight on PATH

その後、通常どおり preflight setup を実行します。

---

ライセンス

Preflight は Apache License 2.0 のもとで公開されているオープンソースです。

---

コントリビューション

コントリビューションを歓迎します！始め方については CONTRIBUTING.md を参照してください。アイデアの共有、質問、機能についての議論には、New Relic Community にご参加ください。

---