HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Agweb – エージェントのための、邪魔にならないブラウザ

Show HN: Agweb – a browser for agents that stays out of your way (github.com)

85 pointsby paul_nameless22 コメント

要約

Agwebは、macOS上で動作する、コーディングエージェント向けのWebKitベースのブラウザです。エージェントがシェルから操作できる単一のウィンドウを提供し、フォーカスを奪ったりサイトをブロックしたりする問題を解決します。アイドルタブのサスペンドによるリソース効率の高さや、エージェント固有の機能(永続的な要素参照、安全なパスワード処理など)が特徴です。

全文翻訳

agweb

macOS上でコーディングエージェントを扱うためのブラウザで、WebKit(Safariのエンジン)をベースにしています。私は複数のコーディングエージェントを同時に実行していますが、PlaywrightのChromeウィンドウはキーボードを奪いがちで、ヘッドレスブラウザは一部のサイトでブロックされ、何が問題だったのか推測するしかありませんでした。agwebは、決してフォーカスを奪わない一つのウィンドウです。エージェントはagwebというplaywright-cli風のコマンドでシェルからこれを操作し、あなたはそれらすべてをライブで監視できます。

[画像: ダッシュボード:すべてのエージェントのタブを一度に表示]

アイドル状態のタブはサスペンドされます。私のMacでは、5つの開いたページがCPU使用率0%で動作していますが、ChromeのGPUプロセスでは5〜7コアがビジーでした。

アイドル状態の5ページメモリ
agweb590 MB
ヘッドレスChrome730 MB
Playwright Chrome1.6 GB
  • 決してフォーカスを奪いません。 ウィンドウが前面に来ることも、ポップアップが表示されることもありません。ダイアログ、タブの切り替え、ファイルピッカー、ダウンロードにはコードで応答します。
  • 常に確認できます。 ダッシュボード(⌘D)は、各エージェントのすべてのタブを一度に、ライブで表示し、各エージェントの最後のコマンドも示します。そして、それは常に実際のウィンドウです。一部のサイトはヘッドレスブラウザをブロックし、ヘッドレスでは何が問題だったのか推測するしかありません。
  • 複数のエージェントを同時に扱えます。 各エージェントは、サイドバーでエージェントごとにグループ化された独自のタブを持つ独自のワークスペースで動作します。
  • 一度ログインすればOK。 名前付きプロファイル(-p work)はログイン情報を保持し、それを使用するすべてのアージェントによって同時に共有されます。
  • 軽量です。 アイドル状態のタブはスロットリングされ、その後サスペンドされるため、誰も使用しなくなった開いたページはほとんどコストがかかりません。
  • 人間のように動作します。 クリックやキー入力はネイティブのmacOSイベントであり、ポインターは手のように動くため、ホバーメニューやドラッグ&ドロップが機能します。
  • エージェントのために作られました。 スナップショットは、ページ上にある間、各要素に参照(ref)を付与します。snapshot --diffとfindは重要なものだけを表示し、各アクションは変更したものを報告します。
  • パスワードはトランスクリプトの外に。 fill --secret-cmd 'pass show site'は、エージェントが応答で決して見ることのない秘密情報を入力します。1PasswordやBitwardenのCLIも動作します。
  • 広告なし。 uBlock Originのリストを使用して広告やトラッカーをブロックしており、agwebは4日ごとにダウンロードします。分析をテストしているエージェントは、独自のワークスペースでそれを無効にできます(agweb -w task adblock off)。
  • デモ動画。 video-startは、ポインターとクリックを描画した状態で、タブをMP4に記録します。

インストール

macOS 26以降が必要です。ReleasesからAgweb.dmgをダウンロードし、AgwebをApplicationsにドラッグして開きます。その後、Help ▸ Install Command Line Tool および Help ▸ Install Agent Skill (for Claude Code and Codex) を選択します。これらはアプリ内のリンクなので、アプリと一緒に更新されます。

代わりにソースからビルドする場合(Xcode 26以降):

./scripts/build.sh
build/Agweb.app/Contents/Helpers/agweb install-cli
agweb install-skill

使用方法

agweb -w task open en.wikipedia.org/wiki/WebKit   # このタスク用のワークスペース。必要に応じてアプリを起動します
agweb -w task snapshot                            # ページを[ref=eN]ハンドル付きのツリーとして表示
agweb -w task click 'role=button[name="Main menu"]'

クリックの応答には、何が変更されたかがすでに記載されているため、エージェントは2回目のスナップショットを必要としません。

### Changes
  - navigation "Site" [ref=e2]
-   - button "Main menu" [ref=e3]
+   - button "Main menu" [checked] [expanded] [ref=e3]
+   - list [ref=e1167]
+     - listitem [ref=e1168]
+       - link "Main page" [ref=e1169]

agweb helpですべてのコマンドのリストが表示されます。設定(⌘,)には、テキストサイズ、ダッシュボードの列、CPUとメモリの表示、広告ブロッカーのスイッチがあります。

Playwright CLIとの比較

可能な限り同じコマンドを使用しているため、エージェントはすでにそれらを理解しています。Playwrightにない名前は、独自のものが提案されます(scroll-to → scroll-into-view)。追加機能:

  • 応答には変更内容が表示されます:フェッチの開始、行の追加または削除、ダイアログ、ポップアップ、ダウンロード、コンソールエラー。ステップごとのスナップショットが少ないため、トークン使用量が大幅に削減されます。
  • 参照(Refs)は要素がページ上にある間持続します。
  • ask は、フォーカスを奪うことなく、ログイン、MFAコード、またはCAPTCHAのためにタブをあなたに引き渡します。
  • アクションは発生したフェッチを待ちます。そのため、エージェントがスリープすることはほとんどありません。
  • text はページのコンテンツをマークダウンとして返します。
  • 共有ログイン:1つのプロファイル上のエージェントは同時に実行されます。Chromeプロファイルは1つのブラウザでのみ開かれます。

制限事項

  • WebKitのみ:Chrome DevTools Protocolがないため、PlaywrightやChrome拡張機能をアタッチできず、Chrome専用サイトでは誤動作する可能性があります。
  • routeはfetchとXHRのみをモックします。requestsはURLのみで画像、スクリプト、スタイルをリストします(--static)。
  • 広告ブロッカーはuBlockのスクリプトを実行できないため、YouTube広告や一部の「広告ブロッカーをオフにしてください」という壁を通過できません。
  • できないことについては、Playwrightを使用してください。

開発

./scripts/selftest.shは、個別のインスタンスでローカルページに対してすべてのコマンドを実行します。swift testは単体テストを実行します。AGWEB_ROOT=/tmp/dirは、あなたのインスタンスの隣に2番目のインスタンスを起動し、すべてをそのフォルダに保存します。Defuddle (MIT) がtextのためにバンドルされています。