block/trailblaze

What it solves

Trailblazeは、AIコーディングエージェントが自然言語を使用して実機（iOS、Android、およびweb）を制御するための方法を提供します。これは、エージェントのコードを書く能力と、ライブアプリケーションのUIと対話する能力の間のギャップを埋めるものであり、開発者がエージェントを使用してアプリを操作し、それらの操作を決定論的なテストとして記録し、AIによる自己修復（self-healing）を通じてそれらを維持することを可能にします。

How it works

Trailblazeは、コーディングエージェント（Claude Code、Cursor、またはGooseなど）がデバイスと対話するために使用できるCLIを提供します。エージェントはsnapshotを使用してUIツリーを読み取り、toolを使用して特定の要素に対してアクションを実行します。これらのセッションは「trails」として保存されます。これは、自然言語の意図とプラットフォーム固有のアクションの両方を記録するYAMLファイルです。これらのtrailsは、その後、LLMを必要とせずにCIで決定論的に再生（replay）したり、--self-healフラグを使用して、組み込みのエージェントを使用して小さなUIの変更をパッチ（修正）したりして再実行したりすることができます。

Who it’s for

これは、異なるプラットフォームにわたるモバイルおよびwebアプリケーションのエンドツーエンドのテストを自動化するために、AIコーディングエージェントを使用する開発者およびQAエンジニア向けに設計されています。

Highlights

• Cross-Platform Control: iOS、Android、およびwebをネイティブの忠実度でサポートし、限定的な機能の交差部分ではなく、完全なアクセシビリティツリーまたはDOMを公開します。
• Agent-Ready Skills: エージェントにCLIの使用方法を教えるためのポータブルなSKILL.md形式が付属しており、エージェントがデバイスをどのように操作するかを正確に把握できるようにします。
• Deterministic Replay: AI主導のセッションを、実行時にLLMを必要とせずにCIで実行できるコミット済みのYAML trailsに変換します。
• AI-Powered Self-Healing: 再生中に軽微なUIのドリフト（テキストの変更やポップアップなど）を自動的にパッチして、壊れやすいテストの失敗を防ぎます。
• Custom Tooling: 開発者がTypeScriptで型定義されたカスタムコマンド（例：loginやaddToCart）を定義することを可能にし、より複雑なエージェントのインタラクションを実現します。
• Trace Viewer: ブラウザベースのレポートビューアを提供し、実行の各ステップに対してスクリーンショット、ビュー階層、およびビデオを提供します。