setup-browser-cookies

ランタイムに関する注意事項

• ワークフローで入力を求めて停止するよう指定されている場合は、ユーザーに直接尋ねてください。
• リポジトリ固有の指示は、AGENTS.md、TODO.md、TODOS.md に記載されている可能性が高いです。
• ワークフローの意図を維持しつつ、環境固有の表現は現在のツールセットに合わせて翻訳してください。

ブラウザーの Cookie を設定する

実際の Chromium ブラウザーから、ログイン済みセッションをヘッドレスのブラウズセッションにインポートします。

仕組み

1. ブラウズ用バイナリを探します
2. cookie-import-browser を実行して、インストール済みのブラウザーを検出し、選択 UI を開きます
3. ユーザーがブラウザーでインポートする Cookie のドメインを選択します
4. Cookie が復号され、Playwright セッションに読み込まれます

手順

1. ブラウズ用バイナリを探す

B=$(browse/bin/find-browse 2>/dev/null || ~/.codex/skills/gstack/browse/bin/find-browse 2>/dev/null)
if [ -n "$B" ]; then
  echo "READY: $B"
else
  echo "NEEDS_SETUP"
fi

NEEDS_SETUP の場合：

1. ユーザーに「gstack browse の初回ビルドが必要です（約 10 秒）。続行してもよろしいですか？」と伝えます。その後、停止して返答を待ちます。
2. 次を実行します：cd <SKILL_DIR> && ./setup
3. bun がインストールされていない場合：curl -fsSL https://bun.sh/install | bash

2. Cookie 選択画面を開く

$B cookie-import-browser

インストール済みの Chromium ブラウザー（Comet、Chrome、Arc、Brave、Edge）を自動検出し、既定のブラウザーでインタラクティブな選択画面を開きます。ここでは次の操作ができます。

• インストール済みのブラウザーを切り替える
• ドメインを検索する
• 「+」をクリックして、ドメインの Cookie をインポートする
• ゴミ箱をクリックして、インポート済みの Cookie を削除する

ユーザーに次のように伝えます：「Cookie の選択画面が開きました。ブラウザーでインポートするドメインを選択し、完了したら教えてください。」

3. 直接インポート（代替手段）

ユーザーがドメインを直接指定した場合（例：setup-browser-cookies github.com）、UI をスキップします。

$B cookie-import-browser comet --domain github.com

指定された場合は、comet を適切なブラウザーに置き換えます。

4. 確認する

ユーザーが完了を確認した後：

$B cookies

インポートした Cookie の概要（ドメインごとの件数）をユーザーに表示します。

注意事項

• ブラウザーごとの初回インポート時に、macOS Keychain のダイアログが表示されることがあります。「許可」または「常に許可」をクリックしてください。
• Cookie の選択画面はブラウズサーバーと同じポートで配信されるため、追加のプロセスは必要ありません。
• UI に表示されるのはドメイン名と Cookie の件数のみで、Cookie の値は公開されません。
• ブラウズセッションではコマンド間で Cookie が保持されるため、インポートした Cookie はすぐに使用できます。