Cuando Pi Coding Agent se ejecuta en tu ordenador: cómo seguirlo desde el móvil

Pi Coding Agent es una de esas herramientas que funcionan a gusto en un ordenador "de verdad":

el repositorio está en local
las herramientas están en local
las sesiones largas son lo normal

Y entonces aparece el deseo de siempre:

Quieres echar un vistazo desde el móvil.

No para hacer una refactorización entera.

Solo para:

ver qué está haciendo
ver si necesita algo de ti
enviar una corrección

Esta guía es el flujo específico para Pi que lo hace llevadero.

Enfoques habituales y sus contrapartidas

SSH desde el móvil
escritorio remoto
esperar
Happier: te da una interfaz en el móvil para revisar el progreso, gestionar aprobaciones y enviar un seguimiento. Contrapartida: sigue dependiendo de que el ordenador que ejecuta la sesión 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 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

En resumen

Instala Pi (pi --version) en el ordenador que ejecutará la sesión.
La autenticación de Pi se basa en variables de entorno (no hay flujo de inicio de sesión interactivo).
Si usas un sistema que admite credenciales conectadas, elige un perfil compatible (OAuth de la suscripción de OpenAI Codex, clave de API de OpenAI, etc.).
Si no se detecta Pi, define HAPPIER_PI_PATH con la ruta absoluta del binario pi.
Usa una interfaz de sesión pensada para el móvil para seguir, aprobar y enviar seguimientos.

El problema

Pi se diferencia de muchos proveedores en que no hay un paso de "iniciar sesión" dentro de la app.

No es un error.

Es un modelo de credenciales:

Pi lee las credenciales admitidas de fuentes basadas en variables de entorno

Así que el flujo desde el móvil no es "iniciar sesión desde el móvil".

Es:

asegurarte de que el ordenador tiene las credenciales correctas
y después seguir la sesión desde el móvil

Paso 1: instala Pi Coding Agent

Según la documentación del proveedor:

npm install -g @mariozechner/pi-coding-agent
pi --version

O con hstack:

hstack providers install pi
pi --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.)

Paso 2: modelo de autenticación (solo variables de entorno)

Pi es un ejemplo claro de "las credenciales viven en el ordenador, no en la interfaz del chat".

En el código fuente, la comprobación de autenticación de Pi está marcada como piEnvOnly.

Este es el comportamiento que debes dar por hecho:

si las credenciales basadas en variables de entorno están en ese ordenador, Pi puede ejecutarse
si no, no puede

Una lista práctica de credenciales

En el ordenador que ejecutará Pi:

Confirma que pi --version funciona.
Decide qué tipo de credencial vas a usar:
- OAuth de la suscripción de OpenAI Codex (conectada)
- clave de API de OpenAI
- clave de API de Anthropic
- perfil setup-token de la suscripción de Claude (no OAuth)
Inicia una sesión pequeña y confirma que puedes enviar un seguimiento.

Si funciona una vez, el flujo desde el móvil se vuelve sencillo: seguir, aprobar y dar un empujón.

Paso 3: perfiles de credenciales conectadas (cuando estén disponibles)

Pi puede reutilizar perfiles de Servicios conectados (Connected services) al iniciarse:

openai-codex (OAuth de la suscripción)
openai (clave de API)
claude-subscription solo con setup-token (token materializado como variable de entorno)
anthropic (clave de API)

Una limitación importante de la documentación del proveedor: