Cómo seguir una sesión de Augment (Auggie) desde el móvil

Augment transmite la sensación de "ponte a programar y ya".

La pega es tener que vigilar el portátil mientras se ejecuta una sesión de Auggie.

Si una tarea va a durar entre 20 y 60 minutos, quieres un flujo en el que puedas:

iniciar la sesión en el ordenador que tiene el repositorio
dejar el ordenador
revisar el progreso desde el móvil
responder a avisos y aprobaciones
enviar un seguimiento

Esta guía es ese flujo.

En resumen

Instala Auggie y comprueba auggie --version en el ordenador que ejecutará la sesión.
Usa un flujo desde el móvil (Happier es una opción) para seguir la sesión, gestionar aprobaciones y enviar seguimientos.
Si el estado de autenticación de Augment muestra desconocido (Unknown), no te alarmes: la comprobación de Auggie es conservadora.
Si no se encuentra Auggie, define HAPPIER_AUGGIE_PATH con la ruta completa del binario auggie.

El problema

"Seguirlo desde el móvil" suele fallar por uno de estos tres motivos:

la sesión se ejecuta en un ordenador que entra en reposo (y la sesión muere)
solo tienes SSH (y el móvil se convierte en una terminal)
la autenticación o el estado son ambiguos (y no te fías de lo que ves)

Auggie es un proveedor basado en una CLI local. Eso es una ventaja: el código se queda donde está tu repositorio.

Pero significa que tu flujo desde el móvil tiene que estar pensado.

Enfoques habituales y sus contrapartidas

SSH desde el móvil: funciona, pero cuesta leer salidas largas en una terminal diminuta.
Escritorio remoto: pesado y engorroso.
Esperar a volver al teclado: seguro, pero lento.
Happier: una app de código abierto para ejecutar y orquestar agentes de programación entre dispositivos. Te permite abrir la sesión de Augment desde el móvil, revisar el progreso, gestionar aprobaciones y dar un empujón con un seguimiento corto. Contrapartida: sigue dependiendo de que el ordenador que ejecuta Auggie esté en línea.

Si Happier es nuevo para ti (qué es y dónde conseguirlo)

Si no conocías Happier: es una app complementaria de código abierto (móvil/web/escritorio) para sesiones de programación.

Para esta guía, la idea clave es sencilla:

Auggie se ejecuta en el ordenador que tiene el repositorio
Happier es donde supervisas la sesión desde el móvil (progreso, aprobaciones, un seguimiento)

Para empezar:

GitHub: https://github.com/happier-dev/happier
Instalación/descarga: https://github.com/happier-dev/happier#how-it-works
Discord: https://discord.gg/W6Pb8KuHfg

Paso 1: instala Auggie en el ordenador que ejecutará la sesión

Según la documentación del proveedor:

npm install -g @augmentcode/auggie
auggie --version

Si usas hstack, también hay un instalador:

hstack providers install auggie
auggie --version

(Si no conocías hstack: es un asistente opcional del ecosistema Happier que puede instalarte las CLI de los proveedores. No lo necesitas, npm install -g ... vale perfectamente.)

Lo importante no es el método de instalación.

Es que auggie --version funcione en el ordenador que ejecutará la sesión.

Paso 2: entiende la autenticación de Auggie (y por qué el estado puede ser "desconocido (Unknown)")

Auggie permite lanzar su propio flujo de inicio de sesión desde los ajustes del proveedor.

Pero la comprobación de autenticación de Auggie es conservadora.

En la configuración de comprobación de autenticación de agentes de Happier, Auggie usa un parser unknown. Eso significa que:

Happier no intentará deducir "con sesión" o "sin sesión" con una comprobación arriesgada
la interfaz puede mostrar desconocido (Unknown) aunque todo esté bien

Así que una buena regla es:

si auggie login funciona en ese ordenador, todo va bien
interpreta "desconocido (Unknown)" como "no se puede comprobar de forma segura", no como "roto"

Una lista práctica para el inicio de sesión

En el ordenador que ejecutará la sesión:

Ejecuta auggie --version.
Ejecuta auggie login (o lánzalo desde los ajustes del proveedor).
Inicia una sesión pequeña y confirma que puedes enviar un seguimiento.

Cuando funcione una vez, puedes olvidarte de la autenticación hasta que falle.

Paso 3: arregla "no se encuentra Auggie" con HAPPIER_AUGGIE_PATH

Si el ordenador de la sesión puede ejecutar auggie pero la app no lo encuentra, el problema suele ser el PATH.

Happier admite una variable de entorno para sobrescribir el binario:

HAPPIER_AUGGIE_PATH

Defínela con la ruta absoluta del ejecutable auggie.

Esta sobrescritura se prueba en los tests del backend de la CLI (no es solo una promesa de la documentación).

Paso 4: inicia una sesión y usa el móvil como monitor

El flujo desde el móvil es estrecho a propósito.

Como un ciclo:

abre la sesión
mira si está esperando una aprobación
envía un seguimiento
sal

Qué hacer desde el móvil (y qué dejar)

Razonable desde el móvil:

aprobar o denegar una solicitud de permiso después de leerla
enviar una corrección corta ("para después de este paso", "no toques X", "resume primero")
echar un vistazo a qué archivos han cambiado

Mejor evitarlo desde el móvil:

cualquier refactorización grande
cualquier cosa que requiera mucho copiar y pegar
cualquier cosa en la que no puedas verificar fácilmente la ruta o el comando

Tres seguimientos para copiar y pegar que funcionan bien con Auggie

Para el caso "desde el móvil", merece la pena reutilizar estos seguimientos:

Punto de control

Para después del siguiente paso y resume:

qué has cambiado

qué no has cambiado

qué quieres hacer a continuación

Restricción

No toques migraciones ni autenticación. Si crees que lo necesitas, para y pregunta.

Primero el diff

Antes de seguir, enumera los archivos que has modificado y por qué (una frase por archivo).

Paso 5: lista de solución de problemas

La sesión no se actualiza

comprueba que el ordenador está en línea y que el runtime de la sesión sigue en marcha
mira si está esperando una aprobación
recarga o vuelve a abrir la sesión

Si has cerrado la tapa del portátil y ese portátil es el anfitrión, da por hecho que la sesión se ha detenido.

No sé si está atascada

Usa la guía de "sesión atascada":

esperando aprobación, desconectada u ocupada

Si Happier es nuevo para ti

Si no conocías Happier: es una app complementaria de código abierto para ejecutar sesiones como Augment/Auggie en un ordenador y seguirlas desde el móvil.

El flujo es básicamente:

Auggie se ejecuta donde está el repositorio
Happier es donde revisas el progreso, gestionas aprobaciones y envías seguimientos

(Y si decides que no quieres otra app, siempre puedes volver a SSH, aunque a la mayoría no le encanta usar SSH en el móvil.)

Para empezar:

GitHub: https://github.com/happier-dev/happier
Instalación/descarga: https://github.com/happier-dev/happier#how-it-works
Discord: https://discord.gg/W6Pb8KuHfg