¿Qué es agent-device?
agent-device da a un agente de código manos y ojos sobre una app en ejecución. El agente toma una instantánea del árbol de accesibilidad de la app, recibe referencias cortas como @e2 para cada botón y campo, y luego toca, rellena, desplaza y comprueba sobre ellas, recurriendo a capturas de pantalla y coordenadas cuando los datos de accesibilidad de una app son pobres. Cubre simuladores, emuladores y dispositivos físicos de iOS y Android, HarmonyOS, tvOS, Android TV, Fire TV, Amazon Vega OS, web, macOS y Linux, con una profundidad que varía según el destino.
El mismo runtime se ofrece de tres formas: una CLI, un servidor MCP por stdio que se arranca con agent-device mcp y un cliente tipado de Node.js. Las ejecuciones se pueden guardar como scripts .ad, reproducir en CI y exportar como YAML de Maestro, y las sesiones se vinculan al worktree de git de quien llama para que agentes en paralelo no se quiten los simuladores. Los dispositivos alojados en BrowserStack, AWS Device Farm, TestMu AI y Limrun usan los mismos comandos.
Lo desarrolla Callstack, la consultora de React Native, bajo la licencia MIT. El repositorio se creó en enero de 2026; la v0.21.36 salió el 2 de noviembre de 2026.
¿Merece la pena agent-device?
agent-device cierra el ciclo que los agentes de código dejan abierto en móvil: pueden escribir una pantalla pero no verla. Lo hace como agent-browser de Vercel lo hace para la web, dando al agente una instantánea compacta de accesibilidad con referencias estables en lugar de pedir a un modelo que razone sobre capturas. Así cada paso gasta pocos tokens y es lo bastante determinista como para grabarlo, y la herramienta en sí no lleva ningún modelo dentro.
Lo que la separa de los muchos servidores MCP móviles pequeños es la fontanería alrededor de la instantánea. Las sesiones se limitan a un worktree de git y los dispositivos se reclaman por host, así que dos agentes en dos worktrees no se pelean por un simulador, y agent-device device release --stale libera las reclamaciones cuyo dueño ha muerto. Una ejecución que el agente resuelve una vez se puede guardar como script .ad y reproducir en CI o exportar a Maestro. El artículo de Expensify muestra el resultado: una skill interna lee los pasos de reproducción de un bug, los resuelve una vez y luego reproduce el script para grabar vídeos de antes y después en cada plataforma para el pull request, un trabajo que el equipo calculó en cinco minutos por plataforma a mano en cientos de incidencias.
El modelo de seguridad está documentado con cuidado. El daemon solo escucha en 127.0.0.1 en puertos efímeros, cada petición necesita un token nuevo de 24 bytes guardado en un archivo 0600, y el servidor MCP nunca expone una shell general. La documentación es igual de clara sobre los riesgos: la herramienta puede manejar cualquier dispositivo y app de escritorio a la que llegue tu cuenta de usuario, y las capturas, los logs y las capturas de red pueden contener credenciales, mientras que el texto escrito puede filtrarse a los logs de XCTest en iOS. Los enlaces a artefactos en la nube deben tratarse como secretos.
El precio es la amplitud y el ritmo de cambios. 108 incidencias y pull requests abiertos, una versión 0.x y lanzamientos frecuentes significan que los comandos todavía se mueven, y el soporte se queda corto en HarmonyOS y Vega OS, que solo cubren una parte de los comandos. MCP tampoco tiene algunos flujos de la CLI, como conectar con nubes de dispositivos y la configuración web, y la documentación sigue recomendando la CLI para ejecuciones largas o manuales en Claude Code. Para una batería de regresión estable, la propia Callstack remite a un framework de pruebas convencional; agent-device es para las comprobaciones exploratorias que hace un agente mientras trabaja, y que luego te deja conservar.
Dónde se gana su sitio
Un desarrollador de React Native en un equipo de producto de 10 personas que usa Claude Code
Que el agente construya una pantalla y demuestre que funciona en ambas plataformas
Instala la CLI, ejecuta agent-device doctor y pide al agente que implemente la pantalla, la abra en el simulador de iOS y el emulador de Android y adjunte capturas. Gratis; la primera ejecución en iOS es más lenta mientras se compila el runner de Apple.
Un responsable de QA en una empresa con cientos de bugs móviles abiertos, como Expensify
Adjuntar grabaciones de antes y después a cada pull request que corrige un bug
Un agente recorre una vez los pasos de reproducción, los guarda como script .ad y lo reproduce en cada plataforma para grabar MP4, lo que según Expensify sustituye unos cinco minutos de captura manual por plataforma.
Un ingeniero de plataforma que ejecuta comprobaciones móviles en CI con runners de Linux
Reproducir flujos grabados por agentes en dispositivos reales sin un laboratorio de dispositivos
Define las credenciales de BrowserStack, AWS Device Farm o Limrun como secretos de CI y ejecuta los scripts guardados contra dispositivos alojados; el proveedor factura el tiempo de dispositivo, y los enlaces a artefactos deben tratarse como secretos.
Antes de decidirte
- Puesta en marcha
- npm install -g agent-device@latest con Node.js 22.12 o posterior (24 para web) y luego agent-device doctor. iOS necesita Xcode, Android necesita el SDK y ADB; los dispositivos iOS físicos necesitan el modo desarrollador y un runner firmado. Añade el servidor MCP con el comando agent-device y el argumento mcp.
- Integraciones
- CLI, servidor MCP por stdio que refleja los comandos instalados más una herramienta de ayuda, y un cliente tipado de Node.js con guías para AI SDK y Eve. Nubes de dispositivos: BrowserStack, AWS Device Farm y Limrun integrados, TestMu AI y Revyl como plugins. Exporta YAML de Maestro; una plantilla de flujo de EAS cubre la CI de Expo.
- Datos y privacidad
- Se ejecuta en local; el daemon escucha en 127.0.0.1 con un token de 24 bytes por arranque. La única llamada saliente por defecto es una comprobación de actualizaciones de npm, que se desactiva con AGENT_DEVICE_NO_UPDATE_NOTIFIER=1. Las capturas, los logs y los volcados de red pueden contener secretos; los proveedores en la nube guardan sus propios artefactos.
- Coste a escala
- La herramienta es gratuita; el uso local solo cuesta un Mac para iOS. Los dispositivos alojados los facturan BrowserStack, AWS Device Farm, TestMu AI o Limrun con sus propias tarifas, que la documentación no recoge; Callstack ofrece servicios de QA para equipos previo contacto, con precio no publicado.
- Límites
- Las sesiones remotas requieren un nombre de sesión; solo Limrun admite port reverse y volcados de red en directo; Limrun y Revyl no guardan artefactos tras cerrar; MCP no puede conectar ni desconectar proveedores en la nube.
Lo bueno
- Instantáneas de accesibilidad con referencias en lugar de razonar sobre capturas
- Sesiones por worktree que impiden que agentes en paralelo compartan simulador
- Graba una vez como scripts .ad, reproduce en CI o exporta a Maestro
- Daemon solo en loopback con tokens por arranque; sin shell por MCP
Lo malo
- Versiones 0.x con 108 incidencias y pull requests abiertos
- HarmonyOS y Vega OS solo cubren una parte de los comandos
- Algunos flujos, como conectar con la nube, son solo de la CLI
- Unas etiquetas de accesibilidad pobres en la app significan ejecuciones menos fiables
Ideal para
Equipos de móvil y React Native que quieren que los agentes de código verifiquen sus propios cambios en simuladores, dispositivos o una nube de dispositivos y adjunten las pruebas a los pull requests.
agent-device: preguntas frecuentes
- ¿Merece la pena agent-device?
- Si tus agentes escriben código móvil, agent-device es la forma de comprobar que funciona, y ya trae la gestión de dispositivos y la reproducción en CI que les faltan a los servidores MCP móviles más sencillos. Le damos un 4.3 sobre 5.
- ¿Cuánto cuesta agent-device?
- Gratis bajo la licencia MIT; las nubes de dispositivos las facturan sus proveedores, y Callstack vende servicios de QA para equipos bajo petición.
- ¿Qué inconvenientes tiene agent-device?
- Versiones 0.x con 108 incidencias y pull requests abiertos; harmonyOS y Vega OS solo cubren una parte de los comandos; algunos flujos, como conectar con la nube, son solo de la CLI; unas etiquetas de accesibilidad pobres en la app significan ejecuciones menos fiables.
- ¿Para quién es agent-device?
- Equipos de móvil y React Native que quieren que los agentes de código verifiquen sus propios cambios en simuladores, dispositivos o una nube de dispositivos y adjunten las pruebas a los pull requests.
- ¿Cuánto cuesta agent-device para un equipo o en producción?
- La herramienta es gratuita; el uso local solo cuesta un Mac para iOS. Los dispositivos alojados los facturan BrowserStack, AWS Device Farm, TestMu AI o Limrun con sus propias tarifas, que la documentación no recoge; Callstack ofrece servicios de QA para equipos previo contacto, con precio no publicado.
- ¿Es agent-device seguro para los datos de la empresa?
- Se ejecuta en local; el daemon escucha en 127.0.0.1 con un token de 24 bytes por arranque. La única llamada saliente por defecto es una comprobación de actualizaciones de npm, que se desactiva con AGENT_DEVICE_NO_UPDATE_NOTIFIER=1. Las capturas, los logs y los volcados de red pueden contener secretos; los proveedores en la nube guardan sus propios artefactos.
Respuestas comprobadas el 5 nov 2026.
¿Desarrollas agent-device? Muestra esta nota en tu web
