agent-deviceとは?
agent-deviceは、コーディングエージェントに動いているアプリを操作する手と見る目を与えます。エージェントはアプリのアクセシビリティツリーのスナップショットを取り、ボタンや入力欄ごとに@e2のような短い参照を受け取り、それに対してタップ、入力、スクロール、検証を行います。アプリのアクセシビリティ情報が乏しいときは、スクリーンショットと座標に切り替えます。対象はiOSとAndroidのシミュレーター、エミュレーター、実機、HarmonyOS、tvOS、Android TV、Fire TV、Amazon Vega OS、Web、macOS、Linuxで、対応の深さは対象によって異なります。
同じランタイムを3つの形で提供します。CLI、agent-device mcpで起動するstdioのMCPサーバー、型付きのNode.jsクライアントです。実行内容は.adスクリプトとして保存してCIで再生でき、Maestro YAMLとして書き出せます。セッションは呼び出し元のgit worktreeに結び付けられるので、並行するエージェントが互いのシミュレーターを奪い合いません。BrowserStack、AWS Device Farm、TestMu AI、Limrunのホスト型デバイスも同じコマンドで使えます。
React Nativeのコンサル ティング会社Callstackが開発し、ライセンスはMITです。リポジトリは2026年1月に作成され、v0.21.36は2026年11月2日に公開されました。
agent-deviceは使う価値があるか?
agent-deviceは、コーディングエージェントがモバイルで残している穴を埋めます。エージェントは画面を書けても、それを見ることができません。agent-deviceは、Vercelのagent-browserがWebで行うのと同じ方法でこれを解決します。モデルにスクリーンショットから推論させるのではなく、安定した参照付きのコンパクトなアクセシビリティのスナップショットを渡すのです。これで各ステップのトークンが少なく済み、記録できるほど決定的になります。ツール自体の中にモデルはありません。
多くの小さなモバイル向けMCPサーバーとの違いは、スナップショットの周りの仕組みです。セッションはgit worktree単位で、デバイスはホストごとに確保されるので、2つのworktreeの2つのエージェントが1台のシミュレーターを奪い合うことはありません。agent-device device release --staleは、持ち主が終了した確保を解放します。エージェントが一度見つけた手順は.adスクリプトとして保存し、CIで再生したりMaestroに書き出したりできます。Expensifyの記事がその成果を示しています。社内のスキルがバグの再現手順を読み、一度手順を確立したうえで、スクリプトを再生して各プラットフォームでプルリクエスト用の修正前後の動画を録画します。手作業ならプラットフォームごとに5分かかるとチームが見積もった作業で、それが数百件のissueにわたります。
セキュリティモデルは丁寧に文書化されています。デーモンは127.0.0.1の 一時ポートだけで待ち受け、すべてのリクエストに0600のファイルに保存された新しい24バイトのトークンが必要で、MCPサーバーは汎用のシェルを公開しません。ドキュメントはリスクについても率直です。このツールはあなたのユーザーアカウントが届くすべてのデバイスとデスクトップアプリを操作でき、スクリーンショット、ログ、ネットワークのキャプチャーには認証情報が含まれうるうえ、入力したテキストがiOSのXCTestのログに漏れることがあります。クラウドの成果物へのリンクは秘密情報として扱うべきです。
代償は範囲の広さと変化の速さです。未解決のissueとプルリクエストが108件、0.xのバージョン番号、頻繁なリリースは、コマンドがまだ変わることを意味します。HarmonyOSとVega OSはコマンドの一部しか対応しておらず、サポートが薄くなります。MCPにはデバイスクラウドへの接続やWebのセットアップなど、CLIの一部のワークフローがなく、ドキュメントはClaude Codeでの長い実行や手動の実行には今もCLIを勧めています。安定した回帰テストのスイートについては、Callstack自身が従来のテストフレームワークを勧めています。agent-deviceは、エージェントが作業中に行う探索的な確認のためのもので、その確認を残せるようにします。
真価を発揮する場面
Claude Codeを使う10人のプロダクトチームのReact Native開発者
エージェントに画面を作らせ、両方のプラットフォームで 動くことを示させる
CLIをインストールしてagent-device doctorを実行し、エージェントに画面を実装させ、iOSシミュレーターとAndroidエミュレーターで開いてスクリーンショットを添付させます。無料です。最初のiOSの実行はAppleのランナーのビルドで遅くなります。
Expensifyのように未解決のモバイルのバグを数百件抱える会社のQAリード
バグ修正のすべてのプルリクエストに修正前後の録画を添付する
エージェントが再現手順を一度たどって.adスクリプトとして保存し、各プラットフォームで再生してMP4を録画します。Expensifyは、これでプラットフォームごとに約5分の手作業の録画が不要になると見積もっています。
LinuxのランナーでモバイルのチェックをCIで回すプラットフォームエンジニア
デバイスラボなしで、エージェントが記録したフローを実機で再生する
BrowserStack、AWS Device Farm、Limrunの認証情報をCIのシークレットに設定し、保存したスクリプトをホスト型デバイスに対して実行します。デバイスの時間は提供元が課金し、成果物へのリンクは秘密情報として扱ってください。
導入前に確認すること
- 導入
- Node.js 22.12以降(Webは24)でnpm install -g agent-device@latestを実行し、続けてagent-device doctor。iOSにはXcode、AndroidにはSDKとADBが必要で、iOSの実機にはDeveloper Modeと署名済みのランナーが必要です。MCPサーバーはコマンドagent-device、引数mcpで追加します。
- 連携
- CLI、インストール済みのコマンドとhelpツールを提供するstdioのMCPサーバー、AI SDKとEveのガイド付きの型付きNode.jsクライアント。デバイスクラウドはBrowserStack、AWS Device Farm、Limrunが組み込み、TestMu AIとRevylがプラグイン。Maestro YAMLを書き出し、EASのワークフローのテンプレートでExpoのCIに対応します。
- データとプライバシー
- ローカルで動き、デーモンは起動ごとの24バイトのトークンとともに127.0.0.1にバインドします。標準で外部に出る通信はnpmの更新確認だけで、AGENT_DEVICE_NO_UPDATE_NOTIFIER=1で止められます。スクリーンショット、ログ、ネットワークのダンプには秘密情報が含まれえます。クラウドの提供元は独自に成果物を保持します。
- 大規模利用時のコスト
- ツールは無料で、ローカルでの利用にかかるのはiOS用のMacだけです。ホスト型デバイスはBrowserStack、AWS Device Farm、TestMu AI、Limrunが各社の料金で課金し、ドキュメントに料金の記載はありません 。Callstackは問い合わせに応じてチーム向けのQAサービスを提供しており、価格は公開されていません。
- 制限
- リモートセッションにはセッション名が必要。ポートのリバースとライブのネットワークダンプに対応するのはLimrunのみ。LimrunとRevylは終了後に成果物を残しません。MCPからはクラウドの提供元への接続も切断もできません。
良い点
- スクリーンショットからの推論ではなく、参照付きのアクセシビリティのスナップショット
- worktree単位のセッションで並行するエージェントがシミュレーターを共有しない
- 一度.adスクリプトに記録し、CIで再生かMaestroへ書き出し
- ループバック限定のデーモンと起動ごとのトークン。MCP経由のシェルなし
気になる点
- 0.xのリリースで、未解決のissueとプルリクエストが108件
- HarmonyOSとVega OSはコマンドの一部のみ対応
- クラウドへの接続など一部のワークフローはCLI限定
- アプリのアクセシビリティラベルが弱いと実行が不安定に
おすすめの人
コーディングエージェントに自分の変更をシミュレーター、実機、デバイスクラウドで確かめさせ、その証拠をプルリクエストに添付させたいモバイルとReact Nativeのチーム。
agent-device:よくある質問
- agent-deviceは使う価値があるか?
- エージェントがモバイルのコードを書くなら、それが動くかを確かめる手段がagent-deviceです。単発のモバイル向けMCPサーバーにはないデバイスの割り当てとCIでの再生をすでに備えています。 評価は5点満点中4.3点です。
- agent-deviceの料金は?
- MITライセンスで無料です。デバイスクラウドは各提供元が課金し、Callstackは依頼に応じてチーム向けのQAサービスを販売しています。
- agent-deviceの欠点は?
- 0.xのリリースで、未解決のissueとプルリクエストが108件; HarmonyOSとVega OSはコマンドの一部のみ対応; クラウドへの接続など一部のワークフローはCLI限定; アプリのアクセシビリティラベルが弱いと実行が不安定に.
- agent-deviceは誰に向いているか?
- コーディングエージェントに自分の変更をシミュレーター、実機、デバイスクラウドで確かめさせ、その証拠をプルリクエストに添付させたいモバイルとReact Nativeのチーム。
- チームや本番環境でagent-deviceを使うと費用はいくらか?
- ツールは無料で、ローカルでの利用にかかるのはiOS用のMacだけです。ホスト型デバイスはBrowserStack、AWS Device Farm、TestMu AI、Limrunが各社の料金で課金し、ドキュメントに料金の記載はありません。Callstackは問い合わせに応じてチーム向けのQAサービスを提供しており、価格は公開されていません。
- agent-deviceは企業データを扱っても安全か?
- ローカルで動き、デーモンは起動ごとの24バイトのトークンとともに127.0.0.1にバインドします。標準で外部に出る通信はnpmの更新確認だけで、AGENT_DEVICE_NO_UPDATE_NOTIFIER=1で止められます。スクリーンショット、ログ、ネットワークのダンプには秘密情報が含まれえます。クラウドの提供元は独自に成果物を保持します。
回答確認日:2026年11月5日
