HN 日本語サマリー

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

Show HN: AIエージェント向け検証ブラウザ – 13msのウィンドウ、ワンコールチェック

Show HN: A verification browser for AI agents – 13ms windows, one-call checks (github.com)

8 pointsby hongnoul_1 コメント

要約

hwatuは、AIエージェントがウェブページを検証する際の速度と効率を劇的に向上させるブラウザです。従来のツールが複数回のAPIコールや遅延を必要とするのに対し、hwatuはワンコールで約35msという高速なチェックを実現し、リソース消費も最小限に抑えます。これにより、エージェントの応答性を高め、開発者の生産性向上に貢献します。

全文翻訳

Headless UI verification for coding agents

[画像: An agent verifies aiuc.com with hwatu: one command returns pixel-match scores for four responsive viewports, then the live page pops into view for human hand-off]

hwatuは、コーディングエージェント向けのヘッドレス検証ハーネスです。CLI、MCP、またはUnixソケット接続ごとの1行のJSONで制御される、ウォームなWebKitデーモンです。エージェントは、「見た目は問題なさそう」ではなく、約35ミリ秒でワンコール検証済みのページチェック、到達可能なピクセル差スコア、数値化されたアニメーション、そして任意の並列性でフォーカスを奪わないヘッドレスウィンドウを得られます。Jcodeはこれをネイティブにbrowserバックエンドとして駆動します。チェックに人間が必要な場合(CAPTCHA、判断が必要な場合)、hwatu focus <id>は同じライブセッションを実際のウィンドウとして具現化します。

Documents

  • Agent guide: プロトコル、プリミティブ、検証ループ
  • Benchmarks: 全ての数値、測定方法、手法を含む
  • Vision: 持続的な製品原則、ネイティブプラットフォーム戦略
  • Human guide: タイリングWMブラウザとしてのhwatu、キーバインド、ハンドオフ
  • Roadmap: ポートフォリオの優先順位と製品境界
  • macOS research:測定されたWKWebViewプローブ、競合スキャン、およびmacOSが検証専用である理由
  • Continuous improvement: アクティベーションメトリック、フィードバックループ、週次ケイデンス
  • Launch kit: 再利用可能なコピー、チャネル、測定計画

Install

curl -fsSL https://raw.githubusercontent.com/hongnoul/hwatu/main/scripts/install.sh | bash

1つの静的バイナリと、お使いのディストリビューションのwebkitgtk-6.0(インストーラーがチェックします)。Archの場合: yay -S hwatu。ソースから: cargo build --release。

次にエージェントを接続します:

hwatu setup             # Claude Code, Cursor, Jcode, または MCP を検出

Verification, not vibes

  • 「ピクセルパーフェクト」は主張です。 match_percent: 97.49 は測定値です。
  • 1回のツールコールで1ページチェック、約35ミリ秒。ウォームサーバーのPlaywrightを同じように実行すると、5回のコールと約9倍の時間がかかります。
  • デフォルトでヘッドレス。ウィンドウはポップアップせず、フォーカスは奪われません。タイピングを続けられます。
  • 1つの静的バイナリ + お使いのディストリビューションのwebkitgtk。Node不要、170MBのChromiumダウンロード不要。

hwatu setupは、設定を変更せずにサポートされているコーディングエージェントを検出します。クライアントを明示的に選択します:

hwatu doctor
hwatu setup --client claude --scope project --dry-run
hwatu setup --client claude --scope project
hwatu demo

セットアップはプレビュー可能(--dry-run)、冪等、および元に戻し可能(--undo)です。手動のMCP設定は、1つのポータブルなエントリです:

{ "mcpServers": { "hwatu": { "command": "hwatu", "args": ["mcp"] } } }

またはMCPをスキップします。各コマンドは、短いCLIコールまたはUnixソケット経由の1行の改行区切りJSONです。

hwatuを接続すると、そのツールが利用可能になります。プロジェクトの指示は、エージェントにいつそれらを使用するかを伝えます。これをAGENTS.md、CLAUDE.md、またはCursorルールに追加します:

## Frontend verification

フロントエンドの変更後にHwatuを使用します。影響を受けるユーザーのジャーニーを実行し、意図された視覚的、ナビゲーション的、または永続的な結果を`expect`で検証します。クリックが成功した、またはコンソールがクリーンであることは成功の証明ではありません。結果を検証した後、追加のJavaScriptおよびリクエストの失敗については`console`を確認してください。

その後、タスクの証拠を具体的にします:

/settings で表示名の編集を実装します。Test Userと入力し、保存し、視覚的な成功状態を検証し、リロードして永続性を確認し、コンソールエラーを報告するためにHwatuを使用します。

検証ループ:

hwatu --headless localhost:3000        # そのウィンドウ。あなたはそれを見ません
hwatu --headless staging.example.com   # 参照

hwatu diff --id 2 --other 1 --heatmap /tmp/heat.png
# {"match_percent":85.13,"regions":[{"x":0,"y":160,"w":2048,...}]}

hwatu motion --id 1                    # 参照のアニメーションを数値で表示
# easing cubic-bezier(0.25,1,0.5,1), 300ms, marquee 29.78px/s ...

# ...エージェントがコードを編集...

hwatu diff --id 2 --other 1
# {"match_percent":97.49}              # 推測より測定値の方が良い

このループは、stripe.comのランディングページのクローンを85.1%から98.8%のピクセル一致まで改善しました。再現するには: scripts/demo/。2番目のリアルエージェントシナリオ(4つのレスポンシブビューポートの差分、その後ライブ人間へのハンドオフ)も証拠とともに表示されます: scripts/demo-aiuc/。

完全な検証パス(オープン、ロード、評価、スクリーンショット、クローズ)は、1つのコマンド、1つのツールコール、中央値約35ミリ秒です(benchmarks):

hwatu check localhost:5173 --eval 'document.title' --shot=/tmp/after.png
# {"title":"My App","eval":"My App","shot":"/tmp/after.png",
#  "console":[...],"load_ms":13,"total_ms":35}

リポジトリレベルの繰り返し可能な契約で、プリフライト、ローカル開発サーバー、レスポンシブスクリーンショット、ソースの鮮度チェック、および証拠レポートも管理する場合:

hwatu verify .hwatu/about.verify.json

同じ実行エンジンがMCPクライアントにもverify_uiとして公開されるため、エージェントハーネスはオーケストレーションループを再構築する必要がありません。agent guideを参照してください。

生成されたHTMLを手元に持ち、サーバーがない場合? hwatu renderは、マークアップを入力として受け取る同じワンコールパスです。一時ファイルやpython3 -m http.serverは不要です:

echo '<h1>generated</h1>' | hwatu render --stdin --shot=/tmp/gen.png
# {"rendered":true,"shot":"/tmp/gen.png","load_ms":5,"total_ms":28}

# ポーリングなしで、ロード、コンソール、ダウンロード、ウィンドウイベントに反応します。
hwatu watch --kinds load,console
# {"event":"load","seq":1,"window_id":7,"data":{"state":"started",...}}

MCPクライアントは、subscribe_eventsを呼び出して、notifications/hwatu/eventと同じストリームを取得します。完全なプロトコルと検証ループについては、agent guideを参照してください。

他の場所では、ヘッドレスは起動時に決定され、人間が決してセッションを見ることはできません。hwatuでは、これはウィンドウプロパティであり、ライブで双方向に切り替え可能です。hwatu focus <id>は、任意のヘッドレスセッションを実際のウィンドウに昇格させ、状態をそのまま保持します。

challengeは設計上、検出とハンドオフのみです。ソルバーAPI、トークン注入、フィンガープリントゲームはありません。

The hand-off destination

ハンドオフが機能するのは、hwatuも実際のブラウザであり、タイリングWM用に構築されているためです。hwatu <url>は、ターミナルがシェルを開くようにウィンドウを開きます(あなたのWMがタブバーであり、ウィンドウにはタブバーはありません)。主流のキーバインド(ctrl+l、ctrl+f、ctrl+kパレット、再バインド可能)、ネイティブ広告ブロック(約119kのEasyListルールがWebKitのコンテンツ拡張エンジンにコンパイルされ、リクエストパスにJSはゼロ)、Chromium風スクロール、および統合されたショートフォームコントロール。すべてのウィンドウは、ウォームデーモン(ウィンドウごとに約56MB)を共有し、フォーカスが外れると一時停止し、最後のURLでクラッシュから復旧します。正直なギャップ:WebKitGTKにはWidevineやpasskeysはありません。WM設定(hyprland、sway、niri)、キーバインド、およびセットアップについては、docs/human.mdを参照してください。

[画像: hwatu as the hand-off destination: quarter-width window spawns and Chromium-curve scrolling in a tiling WM]

Features

  • ヘッドレス/バックグラウンド/フォーカスはウィンドウごとのプロパティで、ライブで切り替え可能
  • 人間へのハンドオフ: hwatu focus <id>でライブセッションをタイリングWMにドロップ
  • ピクセル差スコアリング: 一致率 + 差分領域 + ヒートマップ (diff)
  • 数値化されたアニメーション: 時間、イージング、速度 (motion)
  • 決定論的アニメーションフレーム: 時間tで全てのアニメーションをピン留め (seek)
  • JSONとしてのページ状態、ピクセルではなくトークン (snapshot)
  • 構造化されたエラーを持つリアルな入力イベント (click / type / scroll / upload)
  • JSエラー、コンソール出力、失敗したリクエスト (console)
  • JSONラインまたはMCP通知としてのプッシュイベントサブスクリプション (watch)
  • ワンコールページアサーションとポーリング (expect)
  • CAPTCHA / アンチボット検出と構造化された待機/再開 (challenge)
  • MCPサーバー、プレーンCLI、および1行JSONソケットプロトコル
  • ハンドオフ先としての実際のブラウザ: キーバインド、メディア、広告ブロック、クラッシュ復旧

Why not Playwright or chrome-devtools-mcp?

エージェントにブラウザを提供する3つの方法:

How it runsWhat it costs the agent loop
Cold library (Playwright, launched per task)エンジンはスクリプトの実行時に起動呼び出しは速いが、実行は遅い: 各チェックでエンジンの起動コストが発生; タスク間で状態は引き継がれない
Warm browser (your Chrome + devtools-mcp)完全な人間用ブラウザが常駐レンダリングしないタブ、拡張機能、同期、UIにリソースを消費し、作業中にあなたのフォーカスを奪う
hwatu「最もクールなウォームデーモン」: エンジンはホット、その他はすべて不在8ミリ秒の起動、35ミリ秒の検証済みチェック、あなたが表示を要求するまで(focus)見えない、双方向に中断可能

hwatuは、チェックをインスタントにするもの(エンジン、GPUコンテキスト、コンパイル済み広告ブロック、事前にウォームアップされたWebView)だけを保持し、人間が使用するもの(人間がウィンドウを要求した場合を除く)は何も保持しません。だから、タブバーなしでウォームな状態を維持でき、同じ方法でウォームなPlaywrightサーバーを維持すると、hwatuの39ミリ秒に対してクライアントあたり341ミリ秒かかるのです(benchmarks)。

2番目の違いは、返されるものです。Playwrightとchrome-devtools-mcpは自動化APIです。エージェントはブラウザを駆動し、生のスクリーンショットとDOMを返して目視確認させることができます。hwatuは検証ブラウザです。測定プリミティブ(check、diff、motion、expect)が組み込まれており、ウィンドウのコストは13ミリ秒で、ヘッドレスは起動モードではなくウィンドウプロパティです。

How hwatu compares

凡例: ✅ はい / 内蔵 · 🟡 部分的 / 限定的 · ❌ いいえ

CapabilityPlaywrightchrome-devtools-mcphwatu
Verify pass (load + eval + screenshot), warm in-process82 msn/a35 ms
Verify pass as a warm service (fresh client per check)341 msn/a39 ms
Tool calls per verify pass551
Pixel-diff score + regions + heatmap🟡 1❌✅
Animations as numbers, pinned mid-flight❌ 2🟡 3✅
Headless ↔ headed on a live session❌❌✅
Human hand-off mid-session, state intact❌❌✅
No focus stealing at N parallel agents🟡 4🟡 4✅
CAPTCHA detection + structured wait/resume❌❌✅
No Node, no per-version browser download❌❌✅

1 toHaveScreenshotは保存されたゴールデンと比較します。テストスイートのパス/フェイルであり、エージェントが到達できるスコアではありません。

2 フレーキングを避けるため、通常はアニメーションを無効にするか、終了状態まで早送りします。

3 生のCDPはアニメーション状態をクエリできますが、イージング/速度/キーフレームの数値要約はありません。

4 ヘッドレスは良好ですが、すべてのヘッドレスウィンドウがポップアップしてフォーカスを奪います。

比較は執筆時点の各プロジェクトを反映しています。修正を歓迎します。正直な注意点: Playwrightはコールドスタート(190 vs 435ミリ秒、起動ごとに1回支払い)とメモリでは依然として優れています。hwatuはChromiumではなくWebKitをレンダリングします(エンジン固有のバグのためにCIでPlaywrightマトリックスを維持してください)。そして現時点ではLinuxのみです。完全な直接比較データと手法については、docs/benchmarks.mdを参照してください。

Claude in Chromeについては? カテゴリが異なります。Claude in Chromeは、拡張機能を通じてあなたのChromeを駆動する単一のエージェント製品であり、あなたのプロファイル、タブ、フォーカスを共有し、他のどのエージェントからも呼び出すことはできません。hwatuは、エージェントが安価で繰り返し可能な測定可能なページチェックを必要とする場合に、CLI/MCP経由で呼び出されるクライアントに依存しないデーモンであり、独自のウォームなWebKitエンジンを持ち、デフォルトでヘッドレスであり、検証プリミティブが組み込まれています。Claude in ChromeはClaudeがあなたと一緒にブラウジングできるように使用し、hwatuはエージェントが安価で繰り返し可能な測定可能なページチェックを必要とする場合に使用します。

Feedback

チェックの成功、インストールの失敗、キーバインドの欠落、サイトの破損はすべて有用なシグナルです。2分間のuse reportまたはreport a bugを共有してください。


MITライセンス。Linux。WebKitGTK 6。