큐레이션
agent-device
AI 코딩 에이전트가 iOS·Android 앱을 직접 확인하고 검토 가능한 증거를 남기도록 연결하는 CLI·MCP·Node.js API
요약
agent-device는 AI 코딩 에이전트가 실행 중인 앱을 살펴보고 조작한 뒤, 변경 결과를 실제 기기에서 확인하도록 만드는 모바일 자동화 도구입니다. 공식 README는 CLI, 내장 MCP 서버, 타입이 있는 Node.js API를 같은 실행 경로로 제공한다고 설명합니다.
도구 소개
에이전트는 스크린샷만 보고 추측하는 대신 접근성 스냅샷에서 역할·라벨·ref를 읽고, 그 결과를 바탕으로 탭·입력·스크롤·대기·상태 확인을 이어갈 수 있습니다. 실패를 조사할 때는 스크린샷·영상·로그·트레이스·네트워크·성능 자료를 저장하고, 확인된 흐름은 .ad 스크립트로 반복하거나 Maestro YAML로 내보낼 수 있습니다.
지원 대상은 iOS·Android·HarmonyOS와 tvOS·Android TV·Vega OS TV, 웹·macOS·Linux까지 넓지만 플랫폼별 지원 깊이는 다릅니다. 공식 문서의 capabilities 명령으로 선택한 대상이 실제로 제공하는 명령을 먼저 확인해야 합니다.
사용 포인트
- 코딩 에이전트가 구현한 모바일 화면을 시뮬레이터·에뮬레이터·실기기에서 확인
- 접근성 트리와 selector를 이용해 화면 상태를 읽고 필요한 동작 수행
- 버그 재현 과정의 로그·스크린샷·영상과 검토 가능한 증거를 함께 저장
- 한 번 확인한 흐름을 replay 스크립트로 만들어 CI에서 다시 실행
- MCP를 지원하는 에이전트나 자체 Node.js 에이전트에 같은 기능을 연결
설치와 시작
공식 README가 안내하는 기본 설치 흐름입니다. CLI는 Node.js 22.12 이상이 필요하고, 웹 자동화에는 Node.js 24 이상이 요구됩니다.
npm install -g agent-device@latest
agent-device doctor
agent-device help workflow
이후 agent-device open으로 앱 세션을 열고 snapshot -i로 현재 화면의 상호작용 가능한 요소를 확인합니다. 상태가 바뀐 뒤에는 이전 ref를 계속 쓰지 말고 최신 diff나 스냅샷에서 새 ref를 얻어야 합니다.
적용 판단
agent-device의 핵심은 테스트 케이스를 미리 전부 작성하는 것보다, 에이전트가 실행 중인 앱을 inspect→act→verify 루프로 확인하게 하는 데 있습니다. 모바일 앱을 만드는 팀이 에이전트의 코드 변경과 실제 화면 검증을 한 흐름으로 묶고 싶을 때 살펴볼 만합니다.
다만 기기·플랫폼별 명령과 증거 종류가 같지 않고, 원격 디바이스 클라우드나 CI를 쓰면 별도 환경과 비용이 생깁니다. 처음에는 공식 Quick Start의 작은 앱 하나로 접근성 라벨, ref 안정성, 재현 스크립트가 기대대로 남는지 확인하는 편이 좋습니다.