ChatGPT ブラウザエンジン

repo-harness chatgpt browser-* は、プランニングとレビューのためにローカルで認証された ChatGPT Web セッションを操作します。OpenAI API は使用 せず、OPENAI_API_KEY も必要 ありません。 プロンプトは明示的なリポジトリファイルから構築され、すべての実行はリポジトリローカルなセッション 記録として保存されます。

ブラウザエンジンは Oracle 上で動作します。repo-harness は oracle --engine browser をデフォルトの推奨プロバイダーとしてラップします。古い自前の Chrome エンジンは、非推奨の診断用途としてのみ残されています。

何をするか

明示的なファイルからポリシーチェック済みのプロンプトバンドルを構築し、Oracle を通じて ChatGPT Web を 操作し、セッション記録を .ai/harness/chatgpt/sessions/<sessionId>/ 配下に保存します。

何をしないか

ユーザー名、パスワード、SSO シークレット、2FA コード、Cookie、ブラウザトークンを決して尋ねません。 任意のリポジトリファイルをアップロードせず、デフォルトでリモート CDP を有効にせず、モデルの応答を 決して真実の源として扱いません — リポジトリローカルのセッションストアが監査記録です。

プロバイダーの方針

Oracle がメインの経路です

• oracle — デフォルトの推奨。 Oracle がブラウザエンジンを所有します。repo-harness は常に --engine browser を渡し、自動アーカイブを無効にします。これが使うべきプロバイダーです。
• native — 非推奨。 自前の Chrome DevTools Protocol エンジンはもはやメンテナンスされておらず、 短期的な診断用途（browser-doctor --provider native）としてのみ残されています。今後削除されます。

1. 初回セットアップ

1. セッションのルートを作成し、推奨される無視ルールを表示します（ブラウザの状態はローカルに保持されます）。

   repo-harness chatgpt browser-setup --repo .

2. ピン留めされた Oracle バイナリを解決可能にします — PATH 上、またはリポジトリの node_modules/.bin 内に配置します。Oracle は独自のランタイム要件（Node ≥ 24）を持つ任意の外部 CLI であり、repo-harness の Bun ランタイムとは分離されています。

3. エンジンが準備できていることを確認します（これが Oracle ランタイム境界の権威です）。

   repo-harness chatgpt browser-doctor --repo . --provider oracle --json

   status: "ready" が報告されるまで再実行します。nodeCompatible: false が報告された場合は、まず Oracle の Node ランタイムを修正または再インストールしてください。

ブラウザの状態をソース管理の外に保つ

browser-setup は、ローカルのブラウザプロファイルとセッショントークンの無視ルールを表示します。 これらを決してコミットせず、セッションデータを issue、PR、共有ログに決して貼り付けないでください。

2. ドライラン

ChatGPT を開かずに、プロンプト、ファイルポリシー、インラインサイズ、セッションの書き込みパスを 検証します。dry_run セッションを保存します。

repo-harness chatgpt browser-consult \
  --repo . \
  --dry-run \
  --prompt "Review this sprint." \
  --file plans/sprints/example.sprint.md \
  --model "GPT-5 Pro" \
  --thinking heavy

3. コンサルトを実行する

Oracle がデフォルトのプロバイダーなので、--provider oracle は任意ですが、ここでは分かりやすさのために示します。

repo-harness chatgpt browser-consult \
  --repo . \
  --provider oracle \
  --prompt "Review this PRD and return risks." \
  --file plans/prds/example.prd.md \
  --follow-up "Challenge your previous recommendation." \
  --write-output .ai/harness/handoff/gptpro/chatgpt-review.md

ノート

• --model は ChatGPT のモデルを選択します。--thinking <light|standard|extended|heavy> は Oracle の ブラウザ思考時間にマップされます。サインイン済みの UI で現在選択されているモデルを維持するには --model を省略します。
• 書き出された 回答ファイルが権威です — stdout/stderr はログとしてのみ扱われます。
• 回答ファイルを 生成しない クリーンな終了は、回復可能（ORACLE_CAPTURE_INCOMPLETE）として報告されます。 プロンプトはすでに送信済みの可能性があるため、再送信せずに browser-followup で再接続してください。
• --write-output はリポジトリ相対でなければならず、--overwrite-output を渡さない限り既存のファイルを 上書きしません。絶対パスには人間のみが使用できる --allow-absolute-output が必要です。GPT Pro の出力は .ai/harness/handoff/gptpro/ 配下に保ってください。

4. セッション

repo-harness chatgpt browser-list --repo .
repo-harness chatgpt browser-session --repo . chgpt_20260617_120530_review-sprint
repo-harness chatgpt browser-session --repo . chgpt_20260617_120530_review-sprint --metadata-only
repo-harness chatgpt browser-open --repo . chgpt_20260617_120530_review-sprint

各セッションは自己完結した記録です。

• ディレクトリ.ai/harness/chatgpt/sessions/

  • ディレクトリ<sessionId>/

    • meta.json メタデータ、タイムスタンプ、プロバイダー情報
    • prompt.md 入力プロンプト
    • transcript.md 会話の全文
    • output.md キャプチャされたアシスタントの応答
    • events.jsonl 構造化されたイベントストリーム
    • ディレクトリartifacts/ 任意の生成された成果物

      • …

5. フォローアップとクリーンアップ

フォローアップを保存済みのセッションにリンクします — Oracle を通じてその会話を再開します。

repo-harness chatgpt browser-followup \
  --repo . \
  --session chgpt_20260617_120530_review-sprint \
  --prompt "Turn that review into a Codex-ready goal."

クリーンアップはデフォルトでドライランであり、--force を渡したときにのみ候補を削除します。

repo-harness chatgpt browser-cleanup --repo . --status dry_run --limit 20
repo-harness chatgpt browser-cleanup --repo . --status dry_run --limit 20 --force

6. native プロバイダー（非推奨）

診断専用 — 削除予定

native の Chrome DevTools Protocol プロバイダーは非推奨です。Oracle を優先してください。また、Chrome 136 以降は、デフォルトの Chrome データディレクトリに対するリモートデバッグスイッチをブロックするため、 native を使用する場合は標準ではない --profile-dir が必要です。

repo-harness chatgpt browser-doctor --repo . --provider native
repo-harness chatgpt browser-consult --repo . --provider native --prompt "Reply exactly OK"

native の実行は、ChatGPT Web UI ですでに選択されているモデル／思考モードを使用します。--model または --thinking を渡すとフェイルクローズします。プロバイダー側でのモデル選択が必要な場合は Oracle を使用してください。

7. MCP 経由で公開する（任意）

ブラウザツールは MCP ではデフォルトで無効です。明示的に有効にします。

repo-harness mcp serve \
  --repo . \
  --transport stdio \
  --profile planner \
  --enable-chatgpt-browser

これにより、run_chatgpt_browser_consult、read_chatgpt_browser_session、 list_chatgpt_browser_sessions、open_chatgpt_browser_session、continue_chatgpt_browser_session が公開されます。MCP のコンサルトは、writeOutput を .ai/harness/handoff/*.md、tasks/reviews/**、 .ai/harness/checks/**、plans/prds/**、plans/sprints/** のようなワークフロー成果物に制限します。

ファイルポリシーとセキュリティ

エンジンは、ブラウザやプロバイダーの実行前に拒否されるファイルを却下し、リポジトリ外に解決される 許可パスのシンボリックリンクを却下します。

• デフォルトで許可： AGENTS.md、CLAUDE.md、README.md、docs/**、plans/**、tasks/**、 .ai/context/**、.ai/harness/**、package.json
• デフォルトで拒否： .env / .env.*、秘密鍵と証明書ファイル、.ssh/**、.git/**、 node_modules/**、dist/**、build/**、coverage/**、secrets/**、credentials/**、private/**、 _ops/**、.repo-harness/**/*.json

セキュリティに関する注意

ブラウザプロファイルとローカル設定はコミットしないでください。明示的なセキュリティ計画なしに、localhost の 外へ Chrome のリモートデバッグを公開しないでください。大きい、または機密性の高いコンテキストを送る前に ドライランし、リポジトリ全体のダンプよりも限定されたファイルを優先し、生成された ChatGPT の出力は 権威あるコードの真実ではなく、レビューの入力として扱ってください。

次のステップ

MCP コネクタ ワークフロー成果物を MCP 経由で ChatGPT と Codex に公開する。

ChatGPT Pro プランナー プランとレビューのワークフローを、端から端まで。