AI が iOS・Android・HarmonyOS 上のアプリの状態を確認し、操作・検証する CLI・MCP・Node.js API
中辛 の解説
CLI・MCP サーバー・Node.js API を通じて、AI エージェントがモバイルアプリを検査・操作・検証し、その結果を証拠として保存できるツールです。iOS・Android・HarmonyOS のシミュレータ・エミュレータ・実機、また tvOS・web・macOS・Linux に対応しています。エージェントはアプリのアクセシビリティツリーをトークン効率の良いスナップショットで読み込み、タップ・入力・スクロール・アサーションなどの操作を実行し、スクリーンショット・動画・ログ・パフォーマンスデータで検証できます。セッション機構がマルチエージェント利用時のデバイス制御の競合を防ぎ、.ad スクリプトで作業フローを記録して CI で再実行可能です。ローカル開発から CI・クラウドデバイスまで同じセッションと証拠モデルで動作するため、Expo・React Native・Flutter・ネイティブアプリに統一的に対応できます。Node.js 22.12 以上が必須です。
こんなリポジトリです
こんなときに便利です
- AI コーディングエージェント（Claude Code・Cursor・Windsurf など）が iOS・Android アプリの UI 変更をリアルタイムで検証し、フィードバックループを閉じて開発を加速する場合
- モバイル QA チームが `.ad` スクリーンレコーディングと証拠を保存し、CI パイプラインで自動リプレイして品質保証する場合
- Expensify・Shopify など大規模アプリのエンジニアが、パフォーマンス分析・React Native レンダリング検証・クラッシュログ採集を自動化する場合
主な機能
ほかとの違い
Appium・Detox・Maestro と異なり、エージェントが実行時にアプリ状態を読んで各コマンドを動的に選択し、CLI・MCP・Node.js API の 3 つの入り口とセッション・デバイス所有権・リプレイシステムを統一して提供する点が特徴です。
このリポジトリの作り方
はじめてですか？ むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。
準備するもの
- Node.js 22.12 以上
- iOS Simulator または Android Emulator（対象プラットフォーム）
すぐに始める
- Node.js 22.12 以降をインストール後、
agent-deviceCLI をグローバルインストールします。
npm install -g agent-device@latest
- セットアップを確認します。
agent-device doctor
- iOS Simulator でアプリを開きます（例：連絡先アプリ）。
agent-device open Contacts --platform ios
- 画面の状態をスナップショットで確認し、参照（refs）を取得します。
agent-device snapshot -i
- 返された参照を使用して操作します（例：ボタンをタップ）。
agent-device press @e2 --settle
- セッションを終了します。
agent-device close
ギット飯トライで味見
入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。
ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。
npx gitbap-try callstack/agent-device
Node.js さえあれば、インストールなしで動きます · ギット飯トライとは？ →
これを仕事に活かす
味見がすんだら次は応用です — 仕事やビジネスに活かす方法をまとめました。
レシピ — AI にこのまま頼んでみてください
レシピを読み込んでいます…
スター推移 · 7日
確認日時
使いやすさ · まねしやすいか
- ゆるいライセンス
- テストあり
- サンプル集
- 最近の更新
- AGENTS.md
- llms.txt
- テンプレート
最近の更新あり · 2026 年に作成
「MCP・Claude 連携」 こういうリポジトリを毎週受け取りませんか？
毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。
自分のリポジトリですか？ README にギット飯バッジを貼る
[](https://www.gitbap.com/r/callstack/agent-device)Claude からそのまま使う — ギット飯のつなぎ方
ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。
Claude の設定 → コネクタにこのアドレスを貼り付け。
https://www.gitbap.com/api/mcpプラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI が README をもとに要約しました · 原文を見る