agent-device
코딩 에이전트에 모바일 앱 확인 고리를 붙이는 도구
npm install -g agent-device@latest코딩 에이전트가 자기가 고친 앱을 실제로 돌려 보고 확인하게 해 줍니다. iOS 와 안드로이드, 하모니OS 를 시뮬레이터와 실기기 모두에서 다루고 TV 와 웹, 맥, 리눅스까지 덮습니다. 에이전트는 화면 그림만 놓고 추론하는 대신 토큰 효율이 좋은 접근성 정보를 읽고 참조와 선택자로 조작합니다. 조작 뒤에는 증거를 저장해 검토에 씁니다. 병렬로 도는 여러 작업 공간 사이에서 기기 접근을 조율하고 원격 기기 클라우드에도 붙습니다. 명령줄과 내장 MCP 서버, 타입이 붙은 노드 API 세 가지로 씁니다. 참조는 최신 출력에서만 유효하다는 점이 사용 규칙의 핵심입니다.
판단
이럴 때 씁니다
- 에이전트가 고친 모바일 앱을 직접 확인하게 할 때
- 여러 플랫폼을 같은 방식으로 다뤄야 할 때
- 여러 작업 공간이 기기를 나눠 써야 할 때
이럴 땐 쓰지 마세요
- 화면이 없는 백엔드 작업에는 쓸 데가 없습니다
- 노드 판 요구가 높습니다
- 기기와 시뮬레이터 환경 준비가 따로 필요합니다
차별점
- 화면 그림 대신 토큰 효율이 좋은 접근성 정보를 읽힙니다.
- 모바일과 TV, 웹, 데스크톱을 하나의 도구로 덮습니다.
- 병렬 작업 공간 사이에서 기기 접근을 조율합니다.
- 명령줄과 MCP, 타입이 붙은 노드 API 세 갈래로 씁니다.
워크플로
- 01명령줄 도구를 깝니다.
- 02진단 명령으로 환경을 먼저 확인합니다.
- 03세션을 열고 화면 정보를 읽습니다.
- 04참조로 조작하고 화면이 안정될 때까지 기다립니다.
- 05증거를 남기고 세션을 닫습니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install -g agent-device@latest | 설치합니다. |
agent-device doctor | 에이전트에 넘기기 전에 사람이 먼저 돌리라고 문서가 권합니다. |
agent-device snapshot -i | 화면 정보를 읽습니다. 참조는 이 출력에서만 유효합니다. |
agent-device press @e2 --settle | 조작하고 화면이 안정될 때까지 기다립니다. |
함정
설치 전에 확인하세요
- 참조는 최신 출력에서만 유효합니다. 이전 출력의 참조를 쓰면 엉뚱한 요소를 집습니다.
- 노드 22.12 이상이 필요하고 웹 자동화는 24 이상입니다.
- 진단 명령은 사람이 먼저 돌려야 합니다. 환경 문제를 에이전트가 헤매면 시간이 갑니다.
- 플랫폼마다 준비물이 다릅니다. 시뮬레이터와 실기기, TV 환경이 각각 다릅니다.
비교
화면 이미지로 조작하는 도구는 도달 범위가 넓은 대신 매 단계가 모델 호출입니다. 이쪽은 접근성 정보를 읽히므로 토큰과 시간이 적게 들고 결과가 안정적입니다. 대신 접근성 표시가 없는 요소는 다루기 어렵습니다.
최근 변경
특정 SDK 애플리케이션에서 바로 쓰는 도구 묶음이 공식으로 들어갔습니다. MCP 안내문을 줄이고 MCP 전용 도움말 도구를 붙여 설정과 기능 파악에 드는 부담도 낮췄습니다.