software-mansion/argent

Argent – モバイル、TV、デスクトップアプリの AI 駆動制御

概要

• AI アシスタント（例: ChatGPT、Claude）が iOS シミュレータ、Android エミュレータ/デバイス、Apple/Android/Fire TV、Electron/Chromium アプリと直接対話できるようにするコマンドラインツールです。
• 自然言語の指示と、タップ、スワイプ、タイピング、ハードウェアボタン押下、マウス/キーボード入力などの UI 操作の間のギャップを埋めます。

主な機能

領域	Argent の機能
操作	タップ、スワイプ、ジェスチャー、タイピング、TV での D-pad ナビゲーション、デスクトップアプリでのマウス/キーボードイベントをシミュレートします。
エンドツーエンドテスト	UI 操作のシーケンスを一度記録し、バグ再現やスモークテストのために決定的に再生します。
ビジュアルリグレッション	スクリーンショットのベースラインを取得し、OCR およびフォント認識の比較でライブキャプチャと差分を取ります。
プロファイリング	Hermes、React DevTools、Xcode Instruments、Perfetto にフックし、レンダリングタイミング、CPU ホットスポット、ハングを表示します。
デバッグ	ログのストリーミング、ネットワークトラフィックの傍受（XMLHttpRequest、axios、fetch、Expo）、アプリ内での JS 評価、ネイティブ/React コンポーネントツリーの検査を行います。
React Native サポート	追加設定なしで RN アプリをビルド、起動、反復できます。

使用方法

# プロジェクトでツールを初期化（npm または pnpm）
npx @swmansion/argent@latest init   # pnpm: pnpm dlx @swmansion/argent@latest init

インストール後、AI アシスタントに次のようなコマンドを依頼できます：

• 「iPhone シミュレータでログインボタンをタップして。」
• 「このクラッシュを再現するパスを記録して。」
• 「ホーム画面のビジュアルディフを見せて。」 アシスタントは自然言語リクエストを適切な CLI 呼び出しに変換し、Argent がターゲットデバイスで実行します。

ドキュメントとプライバシー

• 完全なドキュメントは docs.swmansion.com/argent にあり、インストール、サポート対象プラットフォーム、CLI リファレンス、エディタ統合をカバーしています。
• テレメトリはオプトアウト可能です（argent telemetry disable）。収集されるデータについての短いプライバシー通知があります。

ライセンスモデル

• ソースコードは Apache-2.0 ライセンスです。
• プラットフォーム固有のバイナリ（simulator-server、ax-service、.dylib ファイル）は Software Mansion の専有物であり、Argent 内でのみ使用できます。これらのバイナリの再配布やリバースエンジニアリングは禁止されています。

開発元

• Software Mansion によって開発されています。長年の実績を持つエージェンシーであり、React Native のコアコントリビューターです。コンサルティングやカスタム開発サービスも提供しています。

対象ユーザー

• モバイルや TV の UI を操作する AI 搭載アシスタントを構築するチーム。
• iOS、Android、デスクトップで UI フローを記録・再生する単一の CLI を求める QA エンジニア。
• プログラムで駆動できる統合プロファイリング、ビジュアルリグレッション、デバッグツールを探している開発者。

---

すべての情報はリポジトリの README から直接取得しています。