mobile-dev-inc/Maestro

Android・iOS・ウェブアプリのUI自動テストをYAML + AIエージェントで簡単に実行できるオープンソースフレームワーク。

インストール型ツール自由に使える · Apache-2.0自動化・ワークフローKotlin難易度
15,916👀 110 保存
979フォーク411Issue
デモ・公式サイトをひらくmaestro.dev

中辛 の解説

スタック・テクノロジー:Kotlin製で、Java 17以上が必要です。Appiumやセレニウムの後継として、アクセシビリティレイヤー経由でアプリを制御します。使いやすさ:YAMLで記述するため習得曲線が低く、CLIでインストール後すぐ実行できます。Maestro StudioというビジュアルIDE(無料)で、ノーコード的にテストを構築することも可能です。デモ・実行環境:エミュレーター・シミュレーター・実機Android・ブラウザで動作確認できます。既にExpがMetaの内部テストで採用されており、本番環境での信頼性が高いです。難易度:初心者向けで、手書きYAMLなら5分、AIエージェント利用なら即座に開始可能です。

こんなリポジトリです

こんなときに便利です

  • React Native・Flutterなど複数フレームワークのアプリを同じテストで検証したいとき
  • AIコーディングエージェントに自動操作させながらアプリ開発を加速したいとき
  • CIパイプラインで数百個のテストを並列実行して品質を担保したいとき

主な機能

YAML式の人間が読める平坦なテストフローMaestro MCP経由のAIエージェント統合(Claude Code・Cursor対応)Android・iOS・ウェブ統一構文と単一バイナリインストール

ほかとの違い

セレニウム・アペイウムなど従来ツールと異なり、ドライバー・SDK不要の単一バイナリ・YAML平坦コマンド・アクセシビリティレイヤー制御で、フレームワーク非依存かつAIエージェント統合(MCP)をネイティブ搭載しており、モバイル開発チームがCIで大規模並列実行できる設計になっています。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • Java 17以上

すぐに始める

  1. Java 17以上がインストールされていることを確認してください。
java -version
  1. macOS・Linux・Windows(WSL)にMaestro CLIをインストールします。
curl -fsSL "https://get.maestro.mobile.dev" | bash
  1. YAMLファイルでテストフローを作成します。例えば flow_contacts_android.yaml という名前で以下の内容を保存してください。
appId: com.android.contacts
---
- launchApp
- tapOn: "Create new contact"
- tapOn: "First Name"
- inputText: "John"
- tapOn: "Last Name"
- inputText: "Snow"
- tapOn: "Save"
  1. エミュレーターまたは実機Android を接続します。

  2. フローを実行します。

maestro test flow_contacts_android.yaml
  1. (オプション)AIエージェント統合の場合は、Maestro MCPドキュメントに従いClaude CodeやCursorを設定してください。

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try mobile-dev-inc/Maestro

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

これを仕事に活かす

味見がすんだら次は応用です — 仕事やビジネスに活かす方法をまとめました。

レシピ — AI にこのまま頼んでみてください

レシピを読み込んでいます…

スター推移 · 7日

15,9167日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

まねしやすいサンプル評点 46/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2022 年に作成

「自動化・ワークフロー」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/mobile-dev-inc/Maestro.svg)](https://www.gitbap.com/r/mobile-dev-inc/Maestro)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る