agent-device

agent-device es una herramienta de código abierto de Callstack que proporciona a los agentes de IA un bucle de retroalimentación en vivo con aplicaciones en ejecución. Se distribuye como CLI, servidor MCP stdio integrado y cliente Node.js tipado, todos compartiendo el mismo runtime. Los objetivos compatibles incluyen simuladores, emuladores y dispositivos físicos de iOS, Android y HarmonyOS, además de tvOS, Android TV, Amazon Vega OS TV, web, macOS y Linux. Funciona con agentes como Claude Code, Codex, Cursor, Windsurf, Cline y Goose, o como runtime para agentes construidos con AI SDK o Eve. Capacidades principales descritas en el README: - Inspeccionar el estado de la app mediante instantáneas de accesibilidad, refs, selectores y árboles de componentes React Native, en lugar de depender solo de capturas de pantalla. - Actuar sobre la interfaz visible: tocar, presionar, rellenar campos, desplazarse, gestos, esperar, afirmar estado y manejar alertas. - Diagnosticar fallos con capturas de pantalla, video, registros, trazas, datos de red, muestras de rendimiento, detalles de bloqueos y perfiles de React. - Repetir flujos de trabajo guardando pasos como scripts .ad para uso local o en CI, con exportación opcional a YAML Maestro estricto. La instalación se realiza mediante npm (Node.js 22.12+ o 24+ para automatización web), seguida de un comando doctor para verificar la configuración. Las sesiones están limitadas al árbol de trabajo git del llamador, y las reclamaciones de dispositivos locales del host evitan que agentes paralelos tomen control de simuladores y emuladores ajenos. La propiedad del dispositivo se puede inspeccionar y liberar para propietarios obsoletos sin demonio. Los mismos comandos pueden manejar dispositivos alojados en BrowserStack, AWS Device Farm y Limrun. Los backends de plataforma difieren: un puente de accesibilidad local y XCTest para iOS, ADB para Android, HDC y ArkUI uitest para HarmonyOS, Vega CLI/VDA para el dispositivo virtual Vega, un helper local en macOS y AT-SPI en Linux. La profundidad de soporte varía, y un comando de capacidades informa qué soporta cada objetivo. El proyecto se posiciona como complementario a Appium, Detox y Maestro: estos se usan para escribir y mantener suites de pruebas, mientras que agent-device permite que un agente lea el estado de la app y elija comandos en tiempo de ejecución, exportando opcionalmente ejecuciones a esos formatos. Tiene licencia MIT.