Ramus Android

Dale a tu agente de codificación una aplicación Android en ejecución para inspeccionar. La CLI de Ramus puede iniciar un emulador, leer la pantalla, tocar, escribir y capturar evidencia. Requiere Node.js 22 o posterior.

Comienza con una prueba

Ejecuta estos comandos para abrir la aplicación de demostración sin una cuenta:

npx ramus-cli trial
npx ramus-cli session start --demo --wait

Para probar tu propia compilación, reemplaza el segundo comando con:

npx ramus-cli session start --apk app-debug.apk --wait

La prueba almacena una clave temporal localmente y dura 60 minutos. Permite una sesión activa y APKs de hasta 150 MB. Las vistas previas de GitHub y los túneles de desarrollo local requieren una clave API iniciada sesión.

npx resuelve el paquete contra el registro npm en cada invocación, lo que añade aproximadamente 5–8 segundos por comando. Para uso repetido, instálalo una vez con npm i -g ramus-cli y ejecuta ramus directamente; los comandos son idénticos por lo demás.

Abre el watchUrl devuelto para seguir o tomar el control en tu navegador. Si falta, ejecuta npx ramus-cli session share. Cualquiera con este enlace puede operar la aplicación, así que compártelo solo con revisores previstos. Consulta Sesiones de vista previa para la caducidad y el comportamiento de reinicio.

Verifica un flujo

Observa Lee la pantalla.
Obtén referencias frescas.

Actúa Toca, escribe o desliza
sobre lo que encontraste.

Verifica Comprueba el resultado
contra tu objetivo.

Observa de nuevo antes de la siguiente acción

Observa, actúa, verifica. Lee una instantánea y sus valores de ref/gen, actúa sobre esa observación y luego comprueba el resultado. Repite con referencias frescas para la siguiente acción. Un toque aceptado por sí solo no prueba que el flujo funcionó.

Comienza con una observación:

npx ramus-cli snapshot

El resultado incluye elementos visibles con manejadores ref y un contador gen. Usa los valores de ese resultado para tu siguiente acción. Por ejemplo, si muestra un e3 clicable en la generación 1:

npx ramus-cli tap e3 --gen 1 --expect "Welcome"

Reemplaza el texto esperado con el resultado que deseas comprobar. Toma una instantánea fresca antes de elegir otra acción; las referencias antiguas caducan después de una acción aceptada o una instantánea posterior.

• Usa type "hello" --ref <ref> --gen <gen> para enfocar un campo e ingresar texto. Comprueba el valor verified devuelto y observa el resultado.
• Usa wait --text "Welcome" para un estado específico, o wait --stable después de la navegación.
• Captura evidencia con screenshot --out screen.jpg. Si el árbol de UI está incompleto, inspecciona la captura de pantalla y usa coordenadas normalizadas, como tap 0.5,0.72.
• Lee logcat --limit 200 después de un bloqueo. Usa app launch para volver a la aplicación.

Prefija estos comandos con npx ramus-cli. Los comandos usan la sesión más reciente a menos que pases --session <id>. Termina una sesión con npx ramus-cli session end cuando todos hayan terminado.

Conecta tu agente

Para usar un dispositivo ya abierto en tu cuenta, elige Conectar al agente en el encabezado de la página del dispositivo. Configura una clave API de la misma cuenta en el entorno de tu agente, luego copia el Prompt del agente. Incluye el ID de sesión actual y los comandos que inspeccionan ese dispositivo. La pestaña MCP proporciona la URL del servidor e instrucciones para un cliente MCP. Copiar instrucciones no conecta un agente; su primera observación exitosa confirma la conexión.

Los enlaces de compartir anónimos otorgan acceso solo al navegador. Conectarse a través de la CLI o MCP requiere una clave API que pertenezca al propietario del dispositivo.

Pide a tu agente que lea ramus.dev/agents.md, luego dale la ruta del APK y un flujo específico para verificar. Pídele que informe lo que observó e incluya una captura de pantalla y el enlace de vigilancia cuando esté disponible.

Para Claude Code, guarda la habilidad android-use como .claude/skills/android-use/SKILL.md en tu proyecto, o clónala desde github.com/ramus-dev/android-use. Otros agentes pueden usar el mismo flujo de trabajo a través de la CLI.

Los clientes sin acceso a shell pueden usar el servidor MCP remoto en https://api.ramus.dev/api/mcp. Consulta la referencia del agente para la autenticación y las herramientas compatibles. Subir un APK local y ejecutar un túnel de desarrollo requieren la CLI.

Usa tu cuenta

Crea una clave API en Configuración y establece RAMUS_API_KEY en el entorno donde se ejecuta tu CLI o agente. Mantén la clave fuera del chat y las URLs. Ejecuta npx ramus-cli status para verificar la autenticación y las sesiones activas.

Para una compilación de vista previa de GitHub lista:

npx ramus-cli session start --pr owner/repo#123 --wait

Para trabajar en cambios locales con Fast Refresh o recarga en caliente, continúa a Desarrollo local.