Agentty/ドキュメント

アプリ内ブラウザ

ターミナルの横のブラウザパネル、自分で開く開発サーバー、そしてエージェントにページを操作させること。

⇧⌘B でターミナルの横にブラウザパネルが開きます。macOS では Agentty 内の WebKit ビュー、Windows では Microsoft Edge WebView2(Chromium)ビューで、Linux では既定のブラウザが代わりに開きます。WebView2 は Windows 10・11 に標準で入っており、ない PC ではブラウザを開くときに Microsoft 公式のインストーラーをダウンロードしてインストールするよう案内します。

開く方法#

  • ターミナルのリンクを ⌘-クリック(Windows・Linux は Ctrl-クリック)。
  • リンクをどこで開くかは設定 → ブラウザで決めます。
    • アプリ内ブラウザ(ローカルのみ) — 開発サーバー・ローカルのページ・ファイルはここで開き、Web のアドレスはサインイン済みの既定のブラウザで開きます。
    • 既定のブラウザ — すべてのリンクを既定のブラウザで開きます。
  • URL を入力するか、検索語を入力します。検索エンジンは設定で変えられます。

リンクを既定のブラウザで開く設定にすると、アプリ内ブラウザはオフになります。地球儀ボタンは隠れ、⇧⌘B では何も開かず、ファイルのプレビューは既定のブラウザで開き、エージェントにはブラウザツールが渡されず、設定 → ブラウザにはリンクの選択だけが残ります。プラグイン自身のページと、プラグインが開くサインインのウィンドウは引き続き Agentty の中で開きます。

開発サーバー#

タブで起動したローカルサーバーはワークスペース一覧に :ポート のチップとして現れ、ページを返した時点でパネルに開きます。

サーバーを起動したタブを閉じるとサーバーも終了します。どちらの挙動も設定 → 一般と設定 → ブラウザでオフにできます。

レスポンシブモード#

アドレスバー横のスマートフォンボタンを押すと、ページをパネルの幅ではなく端末のサイズで表示します。iPhone SE, iPhone 15 Pro, iPhone 15 Pro Max, Pixel 8, Galaxy S24, iPad mini, iPad Air, iPad Pro 12.9", Laptop, Desktop から選ぶか、幅と高さを自分で入力します。ページはパネルの空きに合わせて中央に配置され縮小されるので、幅 1920 のデスクトップレイアウトも狭いパネルで読めます。回転は 2 つの数値を入れ替え、右端や下端をドラッグすれば手で大きさを変えられます。

オフにすると、ページはパネル本来の幅に戻ります。

Chrome のサインイン情報でサインイン#

macOS でページがサインインを求めると、ページの上のバーで Google Chrome にあるサインイン情報を使うか尋ねます。今後は常にを選ぶと以後は自動で探し、今回のみは今回だけ、いいえは Agentty を再起動するまでそのサイトについて尋ねません。最初に macOS が Chrome の保管キーを Agentty に許可するか尋ねるので、許可を選んでください。

  • 成功するとページがサインイン済みで再読み込みされ、どの Chrome プロファイルから読み込んだかがバーに表示されます。
  • Chrome の情報でサインインできないときはページがぼかされて隠れ、Chrome で認証を完了すると通常 1 分以内に自動で連携されます。ここで認証するを選ぶとページが戻ってここでサインインでき、Chrome で開くを選ぶとそのページが Chrome で開きます。
  • ここでサインアウトすると、30 分間は自動で読み込み直さず、先にバーで尋ねます。

設定 → ブラウザ → サインインで、確認する・常に・オフと、複数ある場合に使う Chrome プロファイルを選べます。選ばなければ最近使ったプロファイルから試し、サインインできなければ次を試します。

コピーするのはブラウザがそのサイトに送る Cookie だけで、インアプリブラウザに入ります(ターミナルごとに分けている場合はそのターミナルの Cookie に)。プラグインのページとプライベートモードでは読みません。エージェントはバーに答えることも特定のサイトを要求することもできず、browser_status の signIn で状況を見るだけです。ただし常ににしていると、誰が開いてもサインインページだけで十分です。エージェントが開いたとき Chrome がそのサイトにサインイン済みなら、見ていないタブでもそのまま入り、そのセッションで動作します。毎回自分で決めるには確認するにしてください。

サインインを作成したブラウザに結び付け、コピーを拒否するサイトもあります。その場合はここで一度サインインしてください。Windows では使えません。Windows の Chrome はキーを Chrome 自体に結び付けています。

エージェントに操作させる#

Claude Code と Codex は MCP を通じてこのブラウザを操作できます。クリック、入力、コンソールの読み取り、スクリーンショットです。エージェントが動いているページで自分の作業を確認する方法です。

エージェントが受け取るツールは次のとおりです。

ツール動作
browser_openこのターミナルのタブを開く(初回は作成)。必要なら URL を読み込む
browser_navigateURL、ホスト:ポート、検索語を読み込む
browser_status現在の URL・タイトルと読み込み中かどうか
browser_wait_load読み込みが終わるまで待つ
browser_click要素をクリック
browser_consoleページのコンソール出力を読む
browser_screenshotページを取り込む
browser_viewport端末サイズ・WxH・off でページを表示
browser_closeこのターミナルのタブを閉じる

Agentty がエージェントを起動するときに一緒に登録するので、導入も設定も要りません。典型的な流れはこうです。エージェントが開発サーバーを立ち上げ、ページを開き、今作った変更をクリックして確かめ、コンソールのエラーを読み、見つかったものを直します。

ターミナルごとに 1 つのブラウザ#

ターミナルごとにブラウザが別にあります。あるターミナルでブラウザを開いてあるサイトを見て、別のターミナルで開いて別のサイトを見ると、ターミナルを選ぶたびにそのターミナルのブラウザが見ていたとおりに現れます。ブラウザを開いたことのないターミナルではパネルは閉じています。見えていないターミナルのページも読み込み、スクリプト、スクリーンショットが動き続けるので、ある作業があなたが見るまで止まることはありません。

  • リンクとサーバーはそのターミナルへ。 ターミナルでクリックしたリンク、そのターミナルが起動したサーバーのポートチップ、ひとりでに開くサーバーのページは、すべてそのターミナルのブラウザに開きます。別のワークスペースのカードのポートチップを押すと、そのターミナルが選ばれます。
  • エージェントはそのターミナルのブラウザの中の自分のタブで働きます。 最初の browser_open で作られ、ターミナルのフォルダと番号(app #3)で表示されます。そのエージェントの操作はすべてこのタブだけに届き、ほかのターミナルのページ、自分で開いたページ、プラグインのページは変えません。ページは画面にあってもなくても 1280px(または browser_viewport で指定したサイズ)で配置され、表示中はパネルに合わせて縮小されるので、パネルの幅で結果が変わりません。
  • 上限で軽く保ちます。 画面外で動くターミナルのブラウザは最大 6 つ、アプリ内ブラウザの全ページが合わせて使うメモリはこのコンピュータのメモリの最大 30% です(どちらも 設定 → ブラウザ で設定)。どちらかを超えると、画面外のブラウザをいちばん前に見たものからメモリから外します。画面上のブラウザと、エージェントが直近 2 分以内にコマンドを送ったブラウザは外しません。外したページはアドレスを覚えておき、そのターミナルを選ぶかエージェントがコマンドを送ると読み込み直します(そのときコマンドは読み込みが終わってから実行します)。
  • パネルを閉じるとそのターミナルのブラウザは隠れ、もう一度開くとそのまま戻ります。ターミナルを閉じるとそのブラウザも閉じます。
  • Cookie とサインイン状態は共有されるので、サイトへのサインインは一度で済みます。エージェントのタブごとに Cookie を分けるには 設定 → ブラウザ → ターミナルごとに Cookie とサインインを分ける をオンにします(macOS 14 以降、Windows は WebView2 ランタイム 101 以降)。ターミナルを閉じるとその Cookie も消えます。
Important

このブラウザは利用者がサインイン済みのセッションを保持します。エージェントが操作すれば、そのセッションの中で動きます。必要なときに使い、どのタブが開いているかを把握しておいてください。