ForgeBridge

ForgeBridge

ロシア語ドキュメント

ステータス：パブリックアルファ／ベータテスト中です。 ForgeBridge は実環境での早期テストに利用できますが、まだ安定した本番リリースではありません。アルファ／ベータ版の間で、コマンド、MCP スキーマ、設定、動作が変更される場合があります。今後も更新、修正、UX の改善、新機能の追加を続けます。

ForgeBridge は、ユーザーが所有し、明示的に使用を許可したコンピューターで開発作業を行うための、ローカルで権限管理された MCP エージェントです。ファイルシステムの編集、対話型ターミナル、永続ジョブ、Git ワークフロー、互換性のある AI クライアントからのセマンティックなブラウザーテスト向けに設計されています。モデル主導の開発では、ForgeBridge はセマンティックなプロジェクト検査、Git の読み取り、レビュー済みの検証操作を提供するため、通常の作業で任意のシェルコマンドを実行する必要はありません。まず project_inspect を使うと、プロジェクトのスタック、Git の状態、ホスト OS、シェルを 1 回の範囲を限定した呼び出しで確認できます。モデルファーストのワークフローを参照してください。

このリポジトリは v0.1 に向けて活発に開発されており、テスト／ベータ版ソフトウェアとして扱ってください。現在の状況と確認済みの制限事項は実装計画で追跡しています。問題の報告やフィードバックを歓迎します。今後のリリースでも、安定性、導入のしやすさ、リモート／複数デバイスでの UX、ツールの対応範囲を引き続き改善していきます。

コントロールセンター

ForgeBridge には、エージェントの動作内容の確認、権限のレビュー、ジョブやセッションの状況確認、監査履歴の確認を、状態ファイルを直接調べることなく行えるローカルのコントロールセンターが含まれています。

プロジェクト	承認

インターフェースは、英語とロシア語、ダークテーマとライトテーマ、レスポンシブレイアウト、実行中のジョブ、セッション、承認、プロジェクトポリシー、および実際のローカル Control API を利用した機密情報を削除済みの監査フィードに対応しています。

プロジェクトの状況

現在の公開リリース： v0.1.0-alpha.4 · チャンネル： next · v1.0 の準備状況の推定： 約68％

この割合は、品質スコアやリリース日ではなく、マイルストーンを加重して算出した推定値です。主要な製品ブロックが実験段階からリリース可能な状態へ移行するたびに更新されます。

項目	状況
ローカルエージェント、権限、監査、ファイルシステム、Git、ターミナル、永続ジョブ、ブラウザー	✅ リリース済み
コントロールセンター、RU/EN、テーマ、ライフサイクル操作、ガイド付きセットアップ	✅ リリース済み
クロスプラットフォーム CI、npm パッケージ、MCP Registry、SBOM／チェックサム	✅ リリース済み
更新／修復／復旧	🟡 進行中
公開 API の安定性、マイグレーション、非推奨化ポリシー	🟡 進行中
マルチデバイス／リモートルーティング	🟠 次の主要な製品ブロック
互換性マトリックス＋独立したセキュリティレビュー	🟠 1.0 より前に必須

次のマイルストーン： 0.2.0-beta.1 — マルチデバイスの基盤、ライフサイクル／更新 UX、最初の互換性凍結。

1.0 への道のりの全容をご覧ください。

クイックスタート

公開アルファ版パッケージの名前は forgebridge で、インストール後のコマンドは forgebridge のままです。最初の npm リリースが公開されたら、次を実行します。

npm install --global forgebridge@next
forgebridge init --root /path/to/your/project
forgebridge doctor
forgebridge browser install
forgebridge serve --transport stdio

stdio サーバーを起動する MCP クライアントは、グローバルインストールなしで ForgeBridge を実行できます。

npx -y forgebridge@next serve --transport stdio

ForgeBridge は、公式 MCP Registry で io.github.t1ktakdev/forgebridge として検索できるよう準備されています。ブラウザーの自動化には、審査済みの Chromium／Chrome／Edge のインストールが必要です。Windows UI Automation は引き続きオプトイン方式です。プラットフォーム固有のセットアップについては、インストールとパッケージングをご覧ください。

設計

ForgeBridge は、ワークステーション上で特権操作の適用を行います。

• すべてのアクションは、拒否を優先する権限エンジンによってチェックされます。
• パスは、正規化された許可済みルートに制限されます。
• 書き込みの承認は、特定のアクションにひも付けられ、有効期限が設けられます。
• ターミナルとジョブの出力には上限が設けられ、ページ分割されます。
• ブラウザーセッションは、デフォルトで分離されます。
• デフォルトの BACKGROUND 実行プロファイルでは、ヘッドレスブラウザーが強制され、フォーカスを変更するデスクトップアクションは後回しにされます。
• 試行されたアクションと完了したアクションは、機密情報を伏せたハッシュチェーン監査ログに記録されます。

ChatGPT Web では、v0.1 で推奨されるトランスポートは OpenAI Secure MCP Tunnelです。これにより、ワークステーションでポートを公開せずに、送信 HTTPS 経路を作成できます。ローカル MCP クライアントでは、stdio を直接利用できます。

以下をご覧ください。

• モデルファーストの開発ワークフロー
• 調査
• アーキテクチャ
• セキュリティモデル
• セキュリティ検証マトリックス
• Windows 検証記録
• 2026-09-15 モデル UX 強化の検証
• リリース準備状況の監査
• 権限モデル
• 脅威モデル
• セキュアトンネル運用手順書
• Windows の自動起動
• バックグラウンド実行とフォーカス保護
• 実装計画

開発

要件：Node.js 22 以降、pnpm 11、Git、ネイティブ検証用の Windows 10/11。

pnpm install
pnpm check
pnpm build
node dist/cli.js init --root C:\src\my-project
node dist/cli.js serve --transport stdio

信頼できるローカル開発

明示的に信頼しているリポジトリでは、ForgeBridge により、リポジトリで定義されたレビュー済みの検証に対する承認プロンプトを繰り返し表示しないようにできます。その場合も、正規のルート境界と厳格な拒否ルールは維持されます。

forgebridge project trust C:\src\my-project

これにより、autonomy: trusted-local を設定したプロジェクトごとの FULL プロファイルが作成されます。これは意図的にローカル設定としてのみ提供されており、リポジトリ内のファイルから有効にすることはできません。これにより、レビュー済みの project_check プランは新たな承認なしで実行できるようになります。一方、破壊的なコマンド、Git のプッシュ、権限昇格、永続化、シークレットへのアクセス、結果に重大な影響を及ぼすブラウザー／Windows での送信、および設定済みルート外のすべての操作には、引き続き承認が必要か、拒否されます。設定を戻すには forgebridge project set PATH --mode balanced --autonomy standard を実行するか、forgebridge project remove PATH でプロジェクトプロファイルを削除します。

ローカルインストール

ForgeBridge は npm 互換の tarball としてパッケージ化されています。これは、node-pty がネイティブ依存関係であり、Playwright のブラウザー実行ファイルがプラットフォーム固有であるためです。リリーススクリプトによる公開は行われません。

pnpm run package:artifact
pnpm run package:validate
.\scripts\install-windows.ps1 -PackagePath .\release\forgebridge-0.1.0-alpha.4.tgz -InstallChromium

成果物には CycloneDX SBOM と SHA-256 チェックサムが含まれています。検証では、実際の tarball を使い捨てのプレフィックスにインストールし、インストール済み CLI、MCP stdio、ファイルシステム、ターミナル、ヘッドレスブラウザーの各パスを実際にテストします。インストールとアップグレードの手順を参照してください。

インストール後、オプションで Windows の自動起動を利用できます。configure-autostart-windows.ps1を使用してください。このスクリプトは、ローカルで明示的に設定した後にのみ現在のユーザー用のスケジュールタスクを作成し、最小権限のトンネル実行時キーを Windows DPAPI で保存します。既定のインストーラーがスタートアップ項目を作成することはありません。

オプションの Windows UI Automation は既定で無効になっています。ローカル設定で windowsUiAutomation.enabled を true にすると、制限付きのセマンティックな Windows 要素ツリーとコントロールパターン操作を利用できます。この機能には、ロック解除済みの対話型デスクトップが必要であり、別のユーザーとの境界や権限昇格の境界を迂回することはありません。フォーカスを変更する操作は、BACKGROUND プロファイルおよび GAMING プロファイルでは永続的に保留され、ローカルでの承認と NORMAL への明示的な切り替えが必要です。

エージェントが自動起動やバックグラウンドサービスを暗黙的にインストールすることはありません。ローカル HTTP エンドポイントをネットワークインターフェイスに公開しないでください。

パブリックアルファ版を公開する前に、リリース準備状況の監査に記載されている、クリーンな Windows VM での別途実行、成果物の署名、独立したセキュリティレビューなど、残りの外部ゲートを完了してください。記録されている Windows 構成での Secure MCP Tunnel／ChatGPT の実環境検証は、すでに合格しています。

セキュリティ

ForgeBridge は、意図的に強力な機能を備えています。承認された任意のシェルは、エージェントの実行に使われている OS アカウントと同じ権限を持ちます。封じ込めるには、専用の低権限アカウント、Windows Sandbox／VM、または OS によって強制される別の隔離境界を使用してください。機密性の高いシステムでエージェントを使用する前に、SECURITY.mdをお読みください。

ライセンス

Apache License 2.0。LICENSEを参照してください。