Show HN: AIエージェント向け検証ブラウザ – 13msのウィンドウ、ワンコールチェック
Show HN: A verification browser for AI agents – 13ms windows, one-call checks (github.com)
要約
hwatuは、AIエージェントがウェブページを検証する際の速度と効率を劇的に向上させるブラウザです。従来のツールが複数回のAPIコールや遅延を必要とするのに対し、hwatuはワンコールで約35msという高速なチェックを実現し、リソース消費も最小限に抑えます。これにより、エージェントの応答性を高め、開発者の生産性向上に貢献します。
全文翻訳
Headless UI verification for coding agents
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を参照してください。
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 runs | What 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
凡例: ✅ はい / 内蔵 · 🟡 部分的 / 限定的 · ❌ いいえ
| Capability | Playwright | chrome-devtools-mcp | hwatu |
|---|---|---|---|
| Verify pass (load + eval + screenshot), warm in-process | 82 ms | n/a | 35 ms |
| Verify pass as a warm service (fresh client per check) | 341 ms | n/a | 39 ms |
| Tool calls per verify pass | 5 | 5 | 1 |
| 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。