La app del móvil

Las cubiertas nativas de privacidad ocultan el contenido de la cuenta antes de que iOS y Android capturen la vista del selector de aplicaciones, incluso sin bloqueo biométrico. Al volver se sigue aplicando la política biométrica. Las notificaciones y otros enlaces ajenos a la autenticación no cancelan un inicio de sesión OAuth pendiente en el navegador del sistema.

El inicio de sesión OAuth nativo utiliza PKCE S256. La aplicación conserva un verificador privado; el callback solo contiene su desafío público. El verificador se envía en el cuerpo de la solicitud de intercambio, nunca en una URL. Cerrar sesión elimina las vistas previas nativas de las notificaciones del teléfono.

La consola funciona en el navegador de un móvil y se puede añadir a la pantalla de inicio como app. La app de AgenticOS para iOS y Android añade lo que solo una app puede hacer: la pantalla de bloqueo, la Dynamic Island, widgets, la hoja de Compartir, push con la app cerrada y un bloqueo propio. Como la app de escritorio, es un shell alrededor de la consola del propio despliegue, así que el inicio de sesión, los permisos y las comprobaciones de tenant son los de la consola.

Captura pendiente — la app del móvil, una live activity y los widgets.

Es una app de Tauri en mobile/, con las mitades nativas - Swift para iOS, Kotlin para Android - en mobile/src-tauri/.

Disponibilidad e instalación propia

Los builds móviles son para desarrollo, no para distribución pública

Compilamos la aplicación móvil en CI, pero actualmente no la publicamos mediante TestFlight, App Store ni Google Play, ni ofrecemos una versión móvil con soporte para descargar. Para usar la aplicación nativa ahora, debes compilarla e instalarla por tu cuenta y conectarla a un despliegue AgenticOS operado por ti o tu organización. No proporcionamos un servidor AgenticOS alojado ni cuentas Apple para firmar la app.

El workflow Apps compila una APK de depuración Android y una aplicación sin firma para el simulador iOS. Son verificaciones de desarrollo, no versiones de tienda. Un build del simulador iOS no se puede instalar en un iPhone físico. Un dispositivo real requiere firma y perfiles de aprovisionamiento propios para la app y sus extensiones.

Tras clonar el repositorio, instala Rust y las herramientas de plataforma: Xcode en macOS para iOS, o Android SDK, NDK y JDK para Android. Después:

cd mobile
bun install --frozen-lockfile
bun run ios        # desarrollo iOS en macOS
# o
bun run android    # desarrollo Android

Al iniciar, introduce la dirección de tu despliegue. Debe ser accesible desde el teléfono; localhost en un teléfono se refiere al propio teléfono, no al ordenador de desarrollo. La versión del navegador/pantalla de inicio permite usar la consola sin compilar la app nativa.

La distribución móvil pública está desactivada por defecto en el workflow de versiones. Activarla más adelante requiere AGENTICOS_MOBILE_RELEASES_ENABLED=true; iOS también requiere AGENTICOS_TESTFLIGHT_ENABLED=true y la configuración de firma descrita en versiones de aplicaciones. Los builds normales de CI siguen activos.

Iniciar sesión

Al escanear se muestran primero el nombre y el correo de la cuenta de destino. Confirma la cuenta para iniciar sesión; cancelar mantiene la sesión actual. La vista previa no consume el código ni prolonga su minuto de validez.

Ajustes → App móvil en la consola muestra un código QR; al escanearlo con la app, puedes confirmar el inicio de sesión con tu cuenta. Un código sirve una vez, durante un minuto, y la sesión del móvil se abre solo tras confirmarlo, con el nombre del propio móvil. También funciona escribir la dirección del servidor e iniciar sesión. La sesión sobrevive a los reinicios, y la app se bloquea tras Face ID, Touch ID o la huella después de cinco minutos fuera.

Sesiones activas, en Ajustes → Perfil, lista cada dispositivo con sesión iniciada: «AgenticOS for iOS 0.2.0» para la app, el navegador en otro caso, y cuáles reciben push. Revocar una allí cierra la sesión de esa app al instante.

Si la conexión inicial o el regreso del inicio de sesión no termina de cargar en 30 segundos, la app vuelve al formulario del servidor con la dirección guardada y un mensaje de conexión. Reintenta o escribe otra dirección. Una copia sin conexión que carga correctamente permanece abierta.

Preparación de la conexión y servidores guardados

Tras iniciar sesión, Termina de configurar este teléfono comprueba la cuenta, un agente publicado disponible, el bloqueo y las notificaciones. También se ofrece a cuentas existentes con ajustes pendientes. Continuar aplaza los pasos opcionales; se pueden revisar en Ajustes → Aplicación móvil. Si cambian los ajustes que faltan, se ofrece otra revisión. La cámara solo se solicita al escanear y el micrófono al iniciar voz, nunca durante estas comprobaciones. Si iOS deniega notificaciones, un botón abre los ajustes del sistema; al volver se revisa el permiso.

Ajustes → Aplicación móvil → Cambiar servidor abre las conexiones guardadas. Asigna un nombre, escanea otro código o introduce una dirección. Se guardan hasta 20 servidores. La dirección existente se migra automáticamente. Volver abre el panel con su sesión persistente. Las cookies y los datos sin conexión no se copian entre orígenes; cerrar sesión o cambiar de cuenta sigue borrando su caché del dispositivo. Cada servidor debe tener un nombre de host diferente: los puertos no aíslan cookies. Quitar una entrada no borra los datos del navegador; cierra sesión antes de compartir el teléfono.

Cambiar elimina primero el registro push del servidor anterior. Si tiene un registro, ese servidor debe estar accesible. Activa push explícitamente en el siguiente. No se mantienen notificaciones de varios servidores a la vez. Las políticas de la organización sobre servidor y bloqueo tienen prioridad; desactivar el bloqueo requiere autenticación del dispositivo.

El cambio también borra Live Activities anteriores, acciones pendientes y agentes fijados en widgets. Los toques de notificaciones nativas se vinculan al inicio de sesión que registró push; una notificación tardía no abrirá una conversación en otro servidor.

Cambiar la cuenta vinculada elimina las notificaciones de Android ya mostradas. Cambiar de servidor también elimina los agentes fijados de las acciones rápidas del icono de la app iOS.

Privacidad de notificaciones

Las preferencias del teléfono pertenecen al inicio de sesión actual. Ajustes → Notificaciones permite ocultar el texto; los ajustes del chat permiten silenciar una conversación. El servidor las aplica antes de enviar APNs o Web Push, incluso con la aplicación cerrada. Un chat visible y enfocado renueva cada 30 segundos una supresión de 90 segundos. Salir del chat o pasar a segundo plano borra el foco; si el proceso termina sin limpieza, caduca como máximo a los 90 segundos. Esto afecta a push, no a la bandeja de entrada ni a las Live Activities en curso.

El test confirma la aceptación del servicio push, no la visualización en ese teléfono. Comprueba la pantalla de bloqueo o el centro de notificaciones. Android usa UnifiedPush y ofrece instrucciones de instalación de ntfy si falta un distribuidor. iOS distingue la falta de configuración APNs de la organización y un permiso del sistema denegado. No se añade Firebase.

Push

Dónde	A través de	Se activa en
iPhone	El servicio push de Apple, con la clave APNs propia de la organización (Admin → Ajustes)	Ajustes de la app → Notificaciones
Android	ntfy (ntfy.sh o un servidor propio de la empresa), no Google	Ajustes de la app → Notificaciones, con la app ntfy instalada
Un navegador, o la consola añadida a la pantalla de inicio	Web Push, con la clave propia del despliegue	Ajustes → Notificaciones

Las notificaciones de cada evento - correo, push - se eligen por evento en Ajustes → Notificaciones. Una notificación abre su página a través del bloqueo de la app.

El push registrado por un inicio de sesión se detiene cuando la sesión se revoca o caduca. Un token vinculado solo recibe mensajes si su sesión pertenece al mismo usuario. Las suscripciones antiguas sin sesión registrada conservan su permiso; elimínalas y regístralas de nuevo para vincularlas al dispositivo actual.

Las vistas previas de APNs se acortan para que el mensaje completo quepa en 4 KiB; una URL de destino demasiado larga abre el dashboard. Un error de tema o entorno APNs conserva el registro del dispositivo para poder corregir la configuración. Si al menos un dispositivo acepta el push antes del límite de tiempo, el envío se considera realizado y no se repite en los ya notificados.

Fuera de la app

Las live activities - la pantalla de bloqueo y la Dynamic Island en iOS, una notificación permanente en Android - muestran lo que está en marcha para ti:

• tus runs en curso, con un reloj;
• una aprobación pendiente, con Revisar aprobación;
• una pregunta cuya respuesta espera un agent, que abre su conversación;
• una llamada de voz en curso, con su reloj, que avisa cuando el agent pregunta algo.

Los enlaces de actividad abren la cola de aprobaciones. Nunca aprueban ni rechazan una herramienta por sí solos: revisa los argumentos y decide en la app. Los enlaces antiguos de aprobación o rechazo también abren la revisión sin decidir.

Widgets. El widget de resumen cuenta las aprobaciones que te esperan y tus runs en curso, con la hora del recuento, y la parte del budget mensual de la organización que queda cuando tiene un límite. El widget de agents fijados abre un chat nuevo con un agent que fijaste en su página; en Android, fijarlo también pone un acceso directo en el launcher con la cara del agent. Las cifras son de la consola y se renuevan cada vez que las lee.

Atajos. El menú de pulsación larga del icono, Atajos y Siri, el botón de Acción y el Centro de control en iOS, y un mosaico de Ajustes rápidos en Android inician una llamada de voz, un dictado, un chat nuevo o las aprobaciones.

Compartir con AgenticOS. La hoja de Compartir de cualquier app ofrece AgenticOS: texto, enlaces, fotos y archivos (hasta 20 MB cada uno) llegan a un mensaje nuevo. Con la app bloqueada no se adjunta nada.

Dentro de la app

• Un chat como una app de mensajería. El + del campo de mensaje abre Cámara, Fotos y Archivos, luego la entrada de voz y los comandos, la llamada, el modelo y las aprobaciones. Al abrir el chat se ofrece una foto hecha hace un momento; solo llegan al mensaje las fotos que tocas.
• Gestos. Desliza una aprobación pendiente a la derecha para aprobarla o a la izquierda para rechazarla, y tira de una página hacia abajo para volver a leerla, con una vibración cuando soltar va a actuar.
• Las páginas se mueven como las del móvil. Una página abierta entra desde el borde final y una a la que se vuelve, desde el inicial. Reducir el movimiento lo desactiva.

El formulario de acceso y el chat se ajustan al área visible sobre el teclado, incluidas la barra de estado y la zona de gestos. Los controles táctiles mantienen un área de pulsación amplia aunque el icono sea pequeño; copiar y ocultar consejos siguen disponibles sin pasar el puntero. El aviso de cookies del navegador no tapa el acceso en la aplicación nativa.

Sin red

La app del móvil, la app de escritorio y la consola añadida a la pantalla de inicio guardan una copia en el dispositivo durante siete días: la lista de conversaciones, las veinte conversaciones abiertas por última vez con sus archivos más nuevos, la cola de aprobaciones y el gasto, los fallos y las conversaciones por retomar del dashboard. La copia está sellada con una clave que ningún script puede leer y se borra al cerrar sesión o al cambiar de organización; una pestaña normal del navegador no guarda nada.

Sin red, la consola muestra esa copia bajo un aviso que dice cuándo se guardó. Un mensaje escrito sin conexión espera sobre el campo de mensaje, sobrevive a cerrar la app y se envía cuando vuelve la conexión; uno que el servidor rechaza vuelve marcado «No enviado» con el motivo.

Instalar la consola en su lugar

En un navegador que puede instalarla, una franja bajo la cabecera de la consola lo ofrece: ventana propia, push y un icono en la pantalla de inicio, sin los extras nativos de arriba. En un iPhone explica cómo - Compartir y luego Añadir a pantalla de inicio. Si se descarta una vez, no vuelve en ese navegador.

Gestión de dispositivos

Una organización puede fijar el servidor al que se conecta la app, bloquearlo para que nadie apunte la app a otro sitio y forzar el bloqueo biométrico activado o desactivado - las claves serverUrl, serverLocked y biometricLock (person | on | off) en las configuraciones gestionadas de Android y la configuración de app gestionada de iOS (AppConfig). Una política que no se puede leer se ignora en lugar de dejar a alguien fuera.

Dónde está en el árbol

• mobile/src-tauri/src/ - los plugins de Rust que llama la consola: live activities (live.rs), widgets (widget.rs), fijados, compartir, push y configuración gestionada.
• mobile/src-tauri/ios/Sources/AgenticOSNative/ - los plugins de iOS y los tipos que la extensión de widgets comparte con la app.
• mobile/src-tauri/gen/apple/Widgets/ - los widgets, los controles y la live activity.
• mobile/src-tauri/gen/android/ - el proyecto de Android: los plugins, los widgets y sus diseños.
• frontend/src/components/mobile/ - la mitad de la consola: lo que está en marcha, las cifras del widget, las acciones que devuelve la app.

Resumen

• La consola se queda en el servidor. La app la abre y añade las superficies propias del móvil.
• En vivo fuera de la app: runs, aprobaciones, preguntas y llamadas en la pantalla de bloqueo; cifras, budget y agents fijados en los widgets.
• Push sin Google en Android, con la clave propia de la organización en el iPhone.
• Una copia en el dispositivo, sellada, para cuando no hay red.