agent-device — AI 에이전트용 iOS/Android 디바이스 제어 CLI
iOS, tvOS, macOS, Android, AndroidTV에서 UI 자동화를 수행하는 CLI. 에이전트 구동 워크플로우에 최적화된 세션 기반 구조로 UI 상태를 검사하고 조작한다. Vercel의 agent-browser와 유사한 개념을 모바일에 적용.
핵심 포인트
- iOS, tvOS, macOS, Android, AndroidTV 지원
- 세션 기반: 타겟을 열고 상호작용 후 정리 종료
- 스냅샷: 접근성 트리를 컴팩트하게 검사하고 안정적인 ref 획득
- Ref vs Selector: ref로 탐색, selector로 내구성 있는 재생·검증
.ad스크립트로 결정론적 e2e 테스트 스위트 실행 가능- 메타데이터 인식 재시도(최대 3회), 테스트별 타임아웃, flaky pass 리포트 지원
사용법
npm install -g agent-device
agent-device open SampleApp --platform ios
agent-device snapshot -i
agent-device press @e3
agent-device fill @e5 "test"
agent-device diff snapshot -i
agent-device close핵심 명령어
| 명령어 | 설명 |
|---|---|
open | 타겟 앱 또는 URL 열기 |
snapshot -i | 현재 화면 검사 |
press @eN | 요소 탭/클릭 |
fill @eN "text" | 텍스트 입력 |
scroll | 스크롤 |
wait | 대기 |
diff snapshot | UI 변경 후 diff |
close | 세션 종료 |
replay | 저장된 .ad 스크립트 재생 |
test | 폴더/glob 기반 직렬 테스트 스위트 |
프로젝트 현황
- Stars: 1,303 | Forks: 75 | Contributors: 20
- 최신 릴리스: v0.11.2 (2026-03-30)
- 언어: TypeScript (92.9%), Swift (6.9%)
- 라이선스: MIT
- 제작: Callstack (React/React Native 전문 기업)
관련 노트
- Optio — 워크플로 오케스트레이터 — AI 코딩 에이전트 워크플로 자동화
- Computer Use — Claude Code 컴퓨터 제어 기능