ghostlight

Ghostlight MCP

エージェントが、いつも使っているブラウザーで見える場所を持てるようにします。

_{ローンチ概要のフォームが空欄の状態から、レビュー可能な状態になるまでをすべて表示します。}

Ghostlight をインストール | 適合する場面を確認 | インストールガイド | トラストセンター

エージェントには、ログイン済みのページが必要です。通常は、セッション情報を何も持たない空のブラウザーを別に用意し、Chrome の内部仕様を学ばなければ何もできないモデルで操作することになります。

Ghostlight は、すでに開いている Chromium 内にタブグループを作成します。作業は目の前で行われるので、見守ることも、一時停止することも、操作を引き継ぐことも、セッションを終了することもできます。モデルが希望を伝え、Ghostlight がブラウザー上の操作を行います。

エージェントに、ページの読み取り、フォームの入力、ファイルの処理、ポップアップの操作、失敗したウェブワークフローの調査を依頼できます。Ghostlight はタブやブラウザーの変更をまたいでタスクを進める一方、ブラウザー操作とその制御機能をお使いのマシン上に保ちます。

明かりを灯したままにして、廊下の安全を守ります。

現在の状況

公開リリースは 2.0.1 です。GitHub リリース v2.0.1、npm パッケージ [email protected]、Chrome ウェブストアのアダプター v2.0.1、MCP レジストリの登録情報 org.sylin/ghostlight 2.0.1 として公開されています。いずれも 2026-10-22 に確認され、 docs/public-status.json および リリース管理記録に記録されています。

利用できる機能

• 23 個のカタログツール：タブ、ナビゲーション、ページの読み取り、スクリーンショット、 セマンティックなクリックとホバー、フォーム入力、ファイルのアップロード、スクリプト、 待機、短いフロー、ダイアログ、診断を扱うブラウザーツールが 22 個と、適用中の権限を 説明するポリシーツールが 1 個あります。1 回の呼び出しで意図を伝えると、Ghostlight が その背後でブラウザー操作を実行します。
• 呼び出しごとに、事実に即した回答を 1 つ：何が起きたか、ブラウザーで何が変わったか、 何が準備できたか、もう一度実行しても安全かを示します。Ghostlight が回答を作成し、 ページの内容は書き換えません。また、独自の復旧手順を最大 2 つ追加します。結果が不確かな 場合は推測せずにその旨を伝え、フォームを二重送信するおそれのある再実行は決して提案しません。
• デスクトップの作業環境：トレイから、作業の進行状況を確認できます。
• お使いのマシン上だけで動作します。 Ghostlight はユーザーとして実行され、ローカル IPC 経由でブラウザーに接続し、ペイロードを含まないローカル記録を保持します。アカウント、 テレメトリー、アクティベーションサービス、更新確認の通信、ホスト型コントロールプレーン、 隠れた別のブラウザーはありません。ネットワーク通信が発生するのは、依頼したブラウジングだけです。

最初の5分間

Chrome、Edge、Brave、または Chromium 125 以降と、MCP クライアントが必要です。npx インストーラーには Node.js が必要ですが、1行インストーラーには不要です。その後に実行するサービスはネイティブの Rust 製です。エージェントのセットアップは Windows と Linux に対応しています。macOS にはまだ対応していません。

1. Ghostlight をインストールします。見つかった MCP クライアントを登録し、Ghostlight のウィンドウを開いて セットアップ手順を表示します。

   npx -y ghostlight install
   

   Node.js がない場合は、お使いのシステム用のワンライナーを使用してください。Windows では、PowerShell で実行します。

   irm https://sylin.org/ghostlight/get.ps1 | iex
   

   Linux では次のコマンドを実行します。

   curl -fsSL https://sylin.org/ghostlight/get.sh | sh
   

2. ウィンドウに表示される手順に従い、「ブラウザーに Ghostlight を追加」を選択します。お使いのコンピューターにあるブラウザーの一覧が表示されます。「追加」を選択すると、そのブラウザーで Chrome ウェブストアの掲載ページが開きます。Edge 用の拡張機能もここから入手できます。ブラウザーに拡張機能がすでにインストールされている場合、行には「開く」と表示されます。

3. エージェントに依頼します。

   sylin.org/ghostlight/demo/desk を開いて、ベルを鳴らしてください。

インストール時に再起動が必要なエージェントが示された場合は、まずそのエージェントを再起動してください。必要な場合はインストール時に案内されます。それ以外に再起動の手順はありません。

ブラウザーに水色の Ghostlight グループが表示され、エージェントが何も送信も保存もしないデモページでベルを鳴らし、ウィンドウに「準備完了」と表示されます。このプロンプトひとつで、接続全体を確認できます。まずは読み取り専用のタスクを試す場合は、次のように依頼してください。

https://example.com/ を Ghostlight の新しいタブで開いて、ページの要約と、使用したタブを教えてください。クリック、入力、送信、ページの変更はしないでください。

セッションが終了すると、Ghostlight が開いたままにしているタブはグループから外れてそのまま残るため、空のグループがブックマークバーに保存されることはありません。次回は、同じエージェントにグループが再び割り当てられ、そのサイトで Ghostlight がエージェント用に開いたままにしていたタブが再利用されるため、作業のたびにタブバーが散らかることはありません。自分が開いたタブや、別のエージェントが開いたままにしているタブを引き継ぐことはありません。ブラウザーの再起動後は、ブラウザーにそのタブが Ghostlight が最後に確認したページのまま表示されている場合に限り、エージェントが記憶しているタブが使われます。そうでない場合、エージェントは新しいタブを開きます。判別できないのは、再起動したブラウザーが自分のタブにエージェントのタブと同じ ID を割り当て、同じアドレスを表示している場合です。たとえば、エージェントのページの復元コピーがこれにあたります。

手順に対応が必要な場合は、次を実行します。

ghostlight doctor

npm でインストールし、ghostlight が PATH にない場合は、npx -y ghostlight doctor で同じチェックを実行できます。

doctor はクライアントの登録情報、ローカルサービス、ブラウザー接続、拡張機能を確認し、次に行うべき操作を示します。インストールガイドでは、特定のクライアントへのセットアップ、ソースからのビルド、更新、アンインストール、症状に応じた復旧について説明しています。

1ページからワークフロー全体へ

ブラウザーでの作業に一連の流れがあるとき、Ghostlight は真価を発揮します。

• サインインした状態から始める。 選んだ Chromium プロファイルでアプリケーションを開き、すでに確立されているセッションを使って作業します。認証情報はブラウザー内に保持されます。
• 操作を最後まで完了する。 ページ移動、フォームへの入力、ファイルのアップロード、ダイアログの解決、ページの状態待ちを行い、あるステップの結果を次のステップに引き継ぎます。
• ブラウザーの動きに追従する。 サイトが対応する子タブを開いたときや、タスクの進行中に既知のワークスペースが変化したときも、作業を続けます。
• 失敗した理由を把握する。 ページの状態、コンソールメッセージ、ネットワークリクエストをまとめて確認し、推測ではなく証拠に基づいて次のデバッグ手順を決めます。

Ghostlight がセットアップする任意のエージェント（対応するエージェントの一覧は インストールガイドに記載）から、または 互換性のある別の stdio MCP クライアントから、同じブラウザー機能を利用できます。エージェントには構造化されたページの読み取り結果、 正確な要素参照、範囲を限定した操作結果、具体的な復旧方法が提供されます。いつでもポリシーツールに、現在有効な権限について説明を求めることができます。

ブラウザーは共有スペースのままです

Ghostlight は、選択したブラウザーウィンドウ内の専用のスカイブルーのタブグループで動作します。ページ のスキャン、クリック、入力、ドラッグ、そして長時間にわたる処理フェーズは、共通の視覚表現で示されるため、画面上の 動きが何を意味するのか分かります。

ワークスペースを一時停止して、慎重な操作のために引き継いだり、停止したりできます。タブは好きな場所に 移動できます。Ghostlight はタブを元に戻すのではなく、ワークスペースに合わせて動作します。 通常のタブはエージェントの管理対象にはなりません。自分で開いたタブが再利用、グループ変更、移動されることは ありません。同じサイト上であっても同様です。また、Ghostlight が開いたままにしたタブで自分でページを読み込むと、そのタブは自分の操作に戻ります。

タブを閉じるには、互いに独立した 2 つの許可が必要です。1 つはオーケストレーターの権限で、そのタブのサイトに対する Action が必要です。もう 1 つはブラウザー独自のタブ保持設定で、出荷時に有効になっています。これにより、何が起きたかを示す証拠が目の前に残ります。自分でタブを閉じる操作はいつでも可能です。

ポリシーマニフェストがなくても、個人利用に必要な機能はすべて揃っています。まずはフルブラウザーエンジンを使い、役立つ作業を始めてください。ワークフローにより強い境界が必要になったら、ドメインごとに read、action、write、execute を許可できます。重要なドメインと構造化監査を追加し、適用前に Check をウィンドウで使うか ghostlight policy simulate を実行して、自分の履歴に対するポリシーをプレビューできます。ブラウザーの操作感は変わりません。 ガバナンスガイドでは運用モデルを説明し、トラストセンターではセキュリティ、プライバシー、継続性、デプロイ、調達に関する情報を掲載しています。

できること、できないこと

ポリシーを設定していない場合、localhost、ループバック、リンクローカルの宛先を含む HTTP(S) の閲覧が許可されます。ホストの制限はポリシーで設定します。HTTP 以外のスキームと古くなったハンドルは、引き続き制限されます。オプションのローカルポリシーと管理ポリシーのレイヤーでは、許可される機能を制限することしかできません。

認証情報の入力には、ユーザーによる明示的な指示が必要です。入力と文字入力では、エージェントからリクエストごとの確認を受け付けます。確認がない場合、セッションを一時停止せずに案内を返します。この確認によってポリシーや、一時停止とセッション終了の操作が覆されることはありません。ポリシーによる拒否が繰り返されても、その後に許可された作業は引き続き実行できます。ポリシーによって遷移先へのアクセスを拒否されたタブは、エージェントが許可されたページに移動するか、閉じるまで保留状態になります。ブラウザーのメッセージとアニメーションは受動的なままで、ボタンを表示したり入力を妨げたりすることはありません。実行時の対話的な制御はワークベンチで行います。

監査記録には、識別子、判定、コンテンツを最小限にした測定値が記録されます。どのツールが実行されたか、権限で許可されたか、所要時間、実行内容です――3 fields、1,240 words、1280x720。操作の遷移先となったサイト名は記録されます。これはエージェントがどこへ移動したかを示すものであり、すでに自分のタブストリップに表示されている情報です。パス、クエリ、フラグメント、ページテキスト、フィールドの値、スクリーンショット、セレクター、ダイアログテキストは記録されません。docs/guides/siem-integration.mdに、記録の正確な形式を示しています。

完全なカタログはdocs/1.0/LANGUAGE.mdに、ポリシースキーマの正確な仕様はdocs/guides/governance-configuration.mdにあります。

ワークベンチ

トレイアイコンを開くと、概要が表示されます。現在実行中のアクションがすべて表示され、その下には完了したアクションが新しい順に積み重なります。各アクションの内容は Ghostlight 自身の言葉で記されます。「example.com を開きました。」「1,240 語を読みました。」「3 つのフィールドに入力してフォームを送信しました。」といった具合です。ページ上の文言が表示されることはありません。隣にはインテグレーションがあります。ここでは、すでに利用しているコーディングクライアントを接続し、バックアップを作成したうえで設定に反映できます（goose と Continue には設定を編集するのではなく、貼り付けるための「セットアップをコピー」が表示されます）。ステータスでは、スタックが正常かどうかを確認できます。ポリシーには、現在のルールで許可されている内容が機能ごとに平易な一行で示され、それぞれを決定したレイヤーも記載されます。設定には、この画面、他に監視を許可するユーザー、ブラウザーの操作、通知、診断の各タブが並び、Ghostlight の終了もここから行えます。概要には、その根底にある約束が記されています。Ghostlight が外部に通信することはありません。

一時停止と再開は、すべてのタブでヘッダーのランプの隣にあり、トレイからも同じ操作ができます。接続済みのブラウザーがあってもなくても機能します。一時停止を保持するのは Ghostlight 自身だからです。設定済みのポリシーが無効な場合、Ghostlight はすべてのブラウザー操作を拒否し、ヘッダーに「準備完了」と表示されることはありません。「ポリシーが無効です」と表示され、ポリシー画面に案内されます。ただし、「未接続」や「一時停止」など、より優先度の高い状態がある場合は、そちらが先に表示されます。すでに適用されているローカルポリシーに誤った編集を加えた場合は別です。最後に有効だったバージョンが引き続き適用され、ステータスには編集に関する警告が表示されますが、ヘッダーは変わりません。ウィンドウを閉じてもアイコンはトレイに残り、Ghostlight は動作を続けます。初回は、その旨を通知で一度だけ知らせます。サービスはディスプレイがなくても動作するため、ウィンドウプログラムを起動できない場合や、コンピューターにディスプレイ、Web ビュー、またはトレイがない場合でも、Ghostlight は動作を続けます。また、ghostlight status にはウィンドウがない理由が表示されます。

ソースからビルドする

Rust 1.89 以降、およびブラウザー検証用の Chromium 125 以降が必要です。

cargo build --workspace

3 つの実行ファイルが並んで生成されます。

• ghostlight-service -- オーケストレーターと、ループバック上で提供するワークベンチです。UI ツールキットにはリンクせず、ディスプレイなしで動作します。
• ghostlight -- エッジです。MCP stdio リレー（ghostlight mcp）、Chromium ネイティブメッセージングリレー、およびその他すべてのコマンドをサービスに渡す入り口です。
• ghostlight-desktop -- シェルです。ウィンドウ、トレイ、通知を担います。Linux でビルドするには WebKitGTK 4.1、GTK 3、AppIndicator の開発パッケージが必要ですが、サービスの実行には必要ありません。

pwsh scripts/dev-loop.ps1 でビルドをデプロイします。ビルドディレクトリ単体では機能しないため、ビルドしたものを開発チャンネルとして ~/.ghostlight/bin にインストールします。 docs/DEV-LOOP.md では、このループ、ブラウザー登録、および検証の全工程について説明しています。

セットアップ後は、起動時の特別な手順は必要ありません。接続済みの MCP クライアントまたは Chromium を起動すると、Ghostlight がまだ実行されていない場合は自動的に起動します。

Windows では、WinGet からもインストールできます。winget install Sylin.Ghostlight を実行し、その後 ghostlight install を一度実行してください。自己完結型の Claude Desktop MCPB も利用できます。どの方法でも、3 つの実行ファイルは ~/.ghostlight/bin に配置されます。WinGet は実行ファイルを配布するだけで、ghostlight install はそこにコピーします。winget upgrade の後に ghostlight install を実行すると、新しいバージョンが配置されます。古いコピーが新しいコピーを置き換えることはありません。WinGet は 2.0.1 のマニフェストが winget-pkgs に承認されるまで 2.0.0 を提供し、1 行のインストーラーは 2.0.1 を提供します。

MCP Client <--stdio--> ghostlight mcp <--relay--> ghostlight-service
    <--relay--> ghostlight (browser) <--native messaging--> Extension <--CDP--> Browser

ライセンスと継続性

Ghostlight は完全に無料のオープンソースです。ガバナンスモジュールを含む、このリポジトリ内のすべてが Apache-2.0 OR MIT のライセンスで提供されています。LICENSING.md では、その対象を説明しています。以前のオープンコア方式と有料プランは、ADR-0140 により撤回されました。

ライセンスの状態が実行時に影響することはありません。確認のためにライセンスへアクセスすることもありません。インストール済みのコピーは、チェックインも有効期限もなく、それぞれの条件のもとで動作し続けます。継続性の約束では、その永続的な内容を示しています。

質問と貢献

再現可能な不具合についてはGitHub Issues、質問やアイデアについてはGitHub Discussions、セキュリティ、ライセンス、または公開すべきでない内容については [email protected] までご連絡ください。

私は AI コーディングエージェントと協力して Ghostlight を開発しています。 CONTRIBUTING.md では、現在の境界と、変更が通過するすべてのゲートについて説明しています。