agent-device의 개요
agent-device는 코딩 에이전트에게 실행 중인 앱을 다룰 손과 눈을 줍니다. 에이전트는 앱의 접근성 트리 스냅숏을 찍어 각 버튼과 입력란에 대해 @e2 같은 짧은 참조를 받은 뒤, 그 참조를 대상으로 탭하고, 입력하고, 스크롤하고, 검증합니다. 앱의 접근성 데이터가 부실하면 스크린숏과 좌표로 대신합니다. iOS와 Android 시뮬레이터, 에뮬레이터, 실제 기기, HarmonyOS, tvOS, Android TV, Fire TV, Amazon Vega OS, 웹, macOS, Linux를 지원하며, 대상에 따라 지원 깊이가 다릅니다.
같은 런타임을 세 가지 방식으로 제공합니다. CLI, agent-device mcp로 시작하는 stdio MCP 서버, 타입이 지정된 Node.js 클라이언트입니다. 실행 과정은 .ad 스크립트로 저장해 CI에서 다시 재생하고 Maestro YAML로 내보낼 수 있으며, 세션은 호출한 쪽의 git worktree에 묶이므로 병렬 에이전트가 서로의 시뮬레이터를 가로채지 않습니다. BrowserStack, AWS Device Farm, TestMu AI, Limrun의 호스팅 기기도 같은 명령으로 씁니다.
React Native 컨설팅 회사인 Callstack이 MIT 라이선스로 만듭니다. 저장소는 2026년 1월에 만들어졌고 v0.21.36은 2026년 11월 2일에 나왔습니다.
agent-device, 쓸 만한 가치가 있습니까?
agent-device는 코딩 에이전트가 모바일에서 열어 둔 고리를 닫습니다. 에이전트는 화면을 작성할 수는 있지만 볼 수는 없습니다. Vercel의 agent-browser가 웹에서 하는 방식처럼, 모델에게 스크린숏을 해석하라고 하는 대신 안정적인 참조가 붙은 간결한 접근성 스냅숏을 건넵니다. 그래서 단계마다 토큰 비용이 낮고 기록해 둘 만큼 결정론적이며, 도구 자체에는 모델이 들어 있지 않습니다.
여러 소형 모바일 MCP 서버와 다른 점은 스냅숏을 둘러싼 배관입니다. 세션은 git worktree 단위로 나뉘고 기기는 호스트별로 점유되므로, 두 worktree의 두 에이전트가 시뮬레이터 하나를 두고 다투지 않으며, agent-device device release --stale은 소유자가 종료된 점유를 정리합니다. 에이전트가 한 번 알아낸 실행 과정은 .ad 스크립트로 저장해 CI에서 재생하거나 Maestro로 내보낼 수 있습니다. Expensify의 글이 그 결과를 보여 줍니다. 내부 스킬이 버그의 재현 단계를 읽고 한 번 따라가 본 뒤, 스크립트를 재생해 풀 리퀘스트용으로 플랫폼마다 수정 전후 영상을 녹화합니다. 팀은 이 작업이 수백 건의 이슈에서 수작업으로 플랫폼당 5분이 걸린다고 추정했습니다.
보안 모델은 꼼꼼하게 문서화되어 있습니다. 데몬은 임시 포트로 127.0.0.1에서만 수신하고, 모든 요청에는 권한 0600 파일에 보관된 새 24바이트 토큰이 필요하며, MCP 서버는 범용 셸을 절대 노출하지 않습니다. 문서는 위험에 대해서도 똑같이 솔직합니다. 이 도구는 사용자 계정이 닿는 모든 기기와 데스크톱 앱을 조작할 수 있고, 스크린숏, 로그, 네트워크 캡처에 자격 증명이 담길 수 있으며, iOS에서는 입력한 텍스트가 XCTest 로그로 새어 나갈 수 있습니다. 클라우드 산출물 링크는 비밀 정보로 다뤄야 합니다.
대가는 넓은 범위와 잦은 변화입니다. 열린 이슈와 풀 리퀘스트 108건, 0.x 버전 번호, 잦은 릴리스는 명령이 아직 바뀐다는 뜻이며, 명령 일부만 지원하는 HarmonyOS와 Vega OS에서는 지원이 얇아집니다. MCP에는 기기 클라우드 연결과 웹 설정을 비롯한 일부 CLI 워크플로도 빠져 있고, 문서는 Claude Code에서 길거나 수동으로 하는 실행에는 여전히 CLI를 권합니다. 안정적인 회귀 테스트 묶음에는 Callstack 스스로 일반적인 테스트 프레임워크를 권합니다. agent-device는 에이전트가 작업하면서 하는 탐색적 확인을 위한 도구이며, 그 확인을 보관할 수 있게 해 줍니다.
제 역할을 하는 곳
Claude Code를 쓰는 10명 규모 제품 팀의 React Native 개발자
에이전트가 화면을 만들고 두 플랫폼 모두에서 작동함을 증명하게 하기
CLI를 설치하고 agent-device doctor를 실행한 뒤, 에이전트에게 화면을 구현해 iOS 시뮬레이터와 Android 에뮬레이터에서 열고 스크린숏을 첨부하라고 요청합니다. 무료이며, 첫 iOS 실행은 Apple 러너를 빌드하는 동안 더 느립니다.
Expensify처럼 열린 모바일 버그가 수백 건인 회사의 QA 리드
모든 버그 수정 풀 리퀘스트에 수정 전후 녹화 첨부하기
에이전트가 재현 단계를 한 번 따라가 .ad 스크립트로 저장하고, 플랫폼마다 재생해 MP4를 녹화합니다. Expensify는 이것이 플랫폼당 약 5분의 수동 캡처를 대체한다고 추정했습니다.
Linux 러너의 CI에서 모바일 검사를 돌리는 플랫폼 엔지니어
기기 연구실 없이 에이전트가 기록한 흐름을 실제 기기에서 재생하기
BrowserStack, AWS Device Farm, Limrun 자격 증명을 CI 시크릿으로 설정하고 저장된 스크립트를 호스팅 기기에서 실행합니다. 기기 사용 시간은 제공업체가 청구하며, 산출물 링크는 비밀 정보로 다뤄야 합니다.
도입 전 확인할 점
- 설정
- Node.js 22.12 이상(웹은 24)에서 npm install -g agent-device@latest를 실행한 뒤 agent-device doctor를 실행합니다. iOS에는 Xcode, Android에는 SDK와 ADB가 필요하고, 실제 iOS 기기에는 Developer Mode와 서명된 러너가 필요합니다. MCP 서버는 명령 agent-device와 인수 mcp로 추가합니다.
- 연동
- CLI, 설치된 명령과 help 도구를 그대로 반영하는 stdio MCP 서버, AI SDK와 Eve 가이드가 있는 타입 지정 Node.js 클라이언트. 기기 클라우드는 BrowserStack, AWS Device Farm, Limrun이 내장되어 있고 TestMu AI와 Revyl은 플러그인입니다. Maestro YAML로 내보내며, EAS 워크플로 템플릿이 Expo CI를 지원합니다.
- 데이터와 개인정보
- 로컬에서 실행됩니다. 데몬은 시작마다 생성되는 24바이트 토큰과 함께 127.0.0.1에 바인딩됩니다. 기본 외부 호출은 npm 업데이트 확인뿐이며 AGENT_DEVICE_NO_UPDATE_NOTIFIER=1로 끌 수 있습니다. 스크린숏, 로그, 네트워크 덤프에 비밀 정보가 담길 수 있고, 클라우드 제공업체는 자체 산출물을 보관합니다.
- 대규모 사용 시 비용
- 도구는 무료이고, 로컬 사용 비용은 iOS용 Mac뿐입니다. 호스팅 기기는 BrowserStack, AWS Device Farm, TestMu AI, Limrun이 각자의 요금으로 청구하며 문서에는 나와 있지 않습니다. Callstack은 문의 시 팀 QA 서비스를 제공하며 가격은 공개되지 않았습니다.
- 제한
- 원격 세션에는 세션 이름이 필요합니다. 포트 역방향 연결과 실시간 네트워크 덤프는 Limrun만 지원합니다. Limrun과 Revyl은 종료 후 산출물을 보관하지 않습니다. MCP로는 클라우드 제공업체를 연결하거나 해제할 수 없습니다.
좋은 점
- 스크린숏 해석 대신 참조가 붙은 접근성 스냅숏
- worktree별 세션으로 병렬 에이전트의 시뮬레이터 공유 방지
- .ad 스크립트로 한 번 기록해 CI에서 재생하거나 Maestro로 내보내기
- 시작마다 토큰을 쓰는 루프백 전용 데몬, MCP로 셸 노출 없음
아쉬운 점
- 열린 이슈와 풀 리퀘스트 108건의 0.x 릴리스
- HarmonyOS와 Vega OS는 명령 일부만 지원
- 클라우드 연결 등 일부 워크플로는 CLI 전용
- 앱의 접근성 레이블이 부실하면 실행이 불안정해짐
추천 대상
코딩 에이전트가 시뮬레이터, 실제 기기, 기기 클라우드에서 자기 변경 사항을 검증하고 그 증거를 풀 리퀘스트에 첨부하기를 원하는 모바일 및 React Native 팀.
agent-device: 자주 묻는 질문
- agent-device, 쓸 만한 가치가 있습니까?
- 에이전트가 모바일 코드를 작성한다면, agent-device는 그 코드가 실제로 돌아가는지 확인하는 방법입니다. 일회성 모바일 MCP 서버에 없는 기기 관리와 CI 재생 기능도 이미 갖추고 있습니다. 평점은 5점 만점에 4.3점입니다.
- agent-device의 가격은 얼마입니까?
- MIT 라이선스로 무료입니다. 기기 클라우드는 각 제공업체가 요금을 청구하며, Callstack은 요청 시 팀 QA 서비스를 판매합니다.
- agent-device의 단점은 무 엇입니까?
- 열린 이슈와 풀 리퀘스트 108건의 0.x 릴리스; HarmonyOS와 Vega OS는 명령 일부만 지원; 클라우드 연결 등 일부 워크플로는 CLI 전용; 앱의 접근성 레이블이 부실하면 실행이 불안정해짐.
- agent-device에 적합한 사람은 누구입니까?
- 코딩 에이전트가 시뮬레이터, 실제 기기, 기기 클라우드에서 자기 변경 사항을 검증하고 그 증거를 풀 리퀘스트에 첨부하기를 원하는 모바일 및 React Native 팀.
- 팀이나 프로덕션 환경에서 agent-device의 비용은 얼마입니까?
- 도구는 무료이고, 로컬 사용 비용은 iOS용 Mac뿐입니다. 호스팅 기기는 BrowserStack, AWS Device Farm, TestMu AI, Limrun이 각자의 요금으로 청구하며 문서에는 나와 있지 않습니다. Callstack은 문의 시 팀 QA 서비스를 제공하며 가격은 공개되지 않았습니다.
- agent-device에 회사 데이터를 맡겨도 안전합니까?
- 로컬에서 실행됩니다. 데몬은 시작마다 생성되는 24바이트 토큰과 함께 127.0.0.1에 바인딩됩니다. 기본 외부 호출은 npm 업데이트 확인뿐이며 AGENT_DEVICE_NO_UPDATE_NOTIFIER=1로 끌 수 있습니다. 스크린숏, 로그, 네트워크 덤프에 비밀 정보가 담길 수 있고, 클라우드 제공업체는 자체 산출물을 보관합니다.
답변 확인일: 2026년 11월 5일.
agent-device 개발사입니까? 이 평점을 사이트에 표시하십시오
