Nota: según la matriz de funciones, las operaciones de escritura de Git (commit, push, pull) son experimentales. Las operaciones de solo lectura (diff, log, status) son estables. Usa las de escritura sabiendo que su comportamiento puede cambiar.

Es habitual quedarse a un commit limpio de "terminado" justo cuando no estás delante del portátil.

Suele ser algo pequeño: una sesión del agente ha terminado, hay un par de arreglos de paso y quieres fijar una base limpia antes de olvidar por qué cambiaron esos archivos.

Desde el móvil, el objetivo no es hacer cirugía con Git. Es un ciclo corto:

Revisar el diff → preparar con intención → escribir un buen mensaje → hacer commit → (quizá) push.

El objetivo es completar ese ciclo desde el móvil sin escritorio remoto y sin convertir el teléfono en un terminal diminuto.

En resumen (el flujo)

La versión rápida:

1. Decide qué enfoque encaja con tus condiciones:
   • control total del terminal (SSH/tmux),
   • revisión solo en PR (GitHub), o
   • una interfaz cómoda en el móvil que trabaja sobre el repositorio donde está.
2. Si usas Happier: configúralo en la máquina que tiene el repositorio (y conecta el móvil). Empieza por: Cómo usar Happier desde el móvil
3. Abre la sesión en el móvil y mira Control de versiones (Source control).
4. Lee el diff en Revisión (Review) antes de preparar nada.
5. Prepara solo lo que va junto.
6. Escribe un mensaje de commit (si quieres, genera un borrador y luego edítalo).
7. Haz commit.
8. Haz push solo si el repositorio está limpio (sin conflictos, sin ir por detrás y sin HEAD separado).

Qué significa en la práctica "hacer commit desde el móvil"

Un commit tiene que ocurrir donde está el árbol de trabajo del repositorio (tu portátil, servidor o máquina de desarrollo). Así que la pregunta no es "¿puede mi móvil ejecutar git?", sino:

• si puedes revisar y controlar el repositorio desde el móvil,
• mientras las operaciones de git se ejecutan en la máquina dueña del espacio de trabajo.

Happier está pensado para ese flujo: el ciclo de "revisar / preparar / confirmar" lo haces desde el móvil, y el repositorio y Git se quedan en la máquina dueña del espacio de trabajo.

Cuándo encaja este enfoque (y cuándo no)

Encaja cuando:

Tienes un repositorio en una máquina que controlas (portátil, servidor, máquina de desarrollo) y quieres una pantalla prudente para revisar diffs, preparar cambios y hacer commit. Y te parece bien que las acciones de escritura de Git estén detrás de un interruptor de función (y puedan figurar como experimentales).

No encaja cuando:

Necesitas reescribir el historial (rebase, reset, cherry-pick), estás en mitad de un conflicto o no se puede acceder a la máquina dueña del repositorio. En esos casos, vuelve a un terminal de verdad.

Enfoques habituales y sus concesiones

Las opciones de siempre:

• SSH + tmux: funciona, pero en el móvil es fácil revisar el diff y preparar cambios con prisa.
• Escritorio remoto: vale para una urgencia puntual, pero en el móvil es pesado y propenso a toques equivocados.
• GitHub para móvil: muy útil cuando el trabajo ya está en una PR, pero no ayuda con el estado sin confirmar de tu máquina.

Lo que encaja mejor se parece a "GitHub Desktop, pero en el móvil", trabajando sobre el repositorio donde está (no sobre una segunda copia en la nube).

• Happier: una app de código abierto para ejecutar y orquestar Claude Code, Codex y otros agentes entre dispositivos. Desde el móvil puedes revisar diffs, preparar cambios con intención y hacer commit, mientras el repositorio y Git se quedan en tu máquina. Concesión: sigue dependiendo de que se pueda acceder a la máquina o al daemon.

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

Si no conoces Happier: es una app complementaria de código abierto (móvil / web / escritorio) para agentes de programación con IA como Claude Code, Codex y OpenCode.

El flujo aquí es: usas Happier para revisar diffs, preparar cambios y hacer commit desde el móvil, mientras la sesión (y el repositorio y Git) se queda en la máquina dueña del espacio de trabajo (portátil, servidor o máquina de desarrollo).

En esta guía, eso significa que puedes hacer el último paso de "revisar + preparar + confirmar" desde el móvil sin escritorio remoto.

Para configurarlo:

• Cómo usar Happier desde el móvil
• GitHub: https://github.com/happier-dev/happier
• Instalación / descarga: https://github.com/happier-dev/happier#how-it-works
• Discord (comunidad y soporte): https://discord.gg/W6Pb8KuHfg

Requisitos previos

Necesitas:

• Una sesión de Happier conectada a la máquina que tiene el repositorio.
• Acceso al repositorio y a los archivos (estas pantallas solo muestran datos reales cuando se puede acceder a las API de espacio de trabajo de la máquina).

Activa las operaciones de escritura de Git (importante)

Por defecto, la navegación del repositorio y la revisión de diffs de Happier pueden estar disponibles, pero las acciones de escritura de Git (stage/unstage/commit/pull/push, etc.) están detrás de un interruptor de función:

• Ve a Configuración (Settings) → Características (Features) → Git operations
• Actívalo (trátalo como experimental)

Si no activas Git operations, puedes seguir usando el mismo flujo para revisar cambios, pero tendrás que terminar el commit desde el terminal.

Paso a paso: haz commit desde el móvil

La disposición exacta de la interfaz cambia entre escritorio y móvil. En pantallas de móvil funcionan mejor las pantallas centradas en "una cosa cada vez" que una barra lateral de escritorio apretada en un espacio diminuto.

1) Abre Control de versiones

En la interfaz de la sesión:

• Abre Control de versiones (Source control) (la pantalla de estado del repositorio)

Deberías ver:

• el resumen de la rama actual
• la lista de archivos cambiados (con estados como A, M, D)
• resúmenes de líneas añadidas y eliminadas cuando estén disponibles

Si no ves el estado del repositorio, ve a Solución de problemas.

Desde la 0.2.12, una revisión puede seleccionar exactamente qué archivos entran en un commit, sin perder de vista el resto del espacio de trabajo. Así puedes confirmar tu arreglo sin arrastrar todo lo demás que haya tocado el agente.

2) Revisa los diffs (antes de preparar)

Haz una pasada rápida antes de preparar nada:

• Abre la pantalla Revisión (Review) para recorrer los diffs sin confirmar como una revisión continua.
• Pliega los archivos que ya hayas revisado.
• Si tienes que arreglar un archivo, ábrelo en el editor, haz el cambio y vuelve a Revisión.

En el móvil, una interfaz pensada para diffs y revisiones te deja orientarte mucho mejor que un terminal a pelo.

3) Prepara los cambios con intención

Desde la lista de archivos cambiados puedes:

• preparar o quitar archivos enteros
• (donde esté disponible) preparar líneas o fragmentos concretos

Al hacer commit desde el móvil, la disciplina al preparar cambios importa más de lo normal. Una buena regla por defecto:

• prepara solo los archivos que forman parte de un único cambio coherente
• deja el formato de paso, los logs de depuración y las ediciones sin relación para otro commit

4) Escribe un mensaje de commit (puedes generar un borrador)

En la parte inferior de Control de versiones, Happier ofrece un editor de commits.

Puedes escribir tu propio mensaje o usar Generate commit message para generar un borrador.

Ojo con esto:

• el generador propone un texto, no hace commit automáticamente
• puedes configurar el backend y las instrucciones en Configuración (Settings) → Control de versiones (Source Control)

Aunque uses el generador, trátalo como un autocompletado: echa un vistazo al diff preparado y ajusta el mensaje a lo que de verdad has preparado.

5) Haz commit

Confirma los cambios preparados.

Si Happier bloquea la acción, suele ser porque el repositorio está en un estado poco seguro para operaciones automáticas desde la interfaz (conflictos, HEAD separado, etc.). Es intencionado.

6) Push (opcional): conoce las protecciones

Si decides hacer push desde el móvil, espera protecciones prudentes. Es una decisión intencionada: prefiere rechazar un push arriesgado antes que dejarte reescribir el historial desde una pantalla pequeña.

Ejemplos de reglas con las que te puedes encontrar:

• pull solo fast-forward
• push/pull/revert se bloquean cuando HEAD está separado
• push se bloquea cuando la rama local va por detrás del upstream
• push/pull/revert se bloquean mientras haya conflictos

Si te topas con un bloqueo, suele ser el momento de:

• arreglar el estado del repositorio desde un terminal completo, o
• cambiar de rama, limpiar o resolver los conflictos primero.

Un flujo práctico para sesiones de programación con IA (Claude/Codex, etc.)

Si la necesidad de "hacer commit desde el móvil" viene de una sesión con un agente, un ciclo para el móvil que funciona bien es:

1. Revisa lo que ha cambiado el agente en Revisión
2. Haz ediciones pequeñas con el editor integrado (corregir nombres, quitar archivos creados por error)
3. Haz commit con un mensaje conciso
4. Envía al agente una instrucción de seguimiento ("sigue desde esta base limpia")

Un hábito sutil pero útil: usa Vincular archivo (Link file) en el editor de mensajes o las herramientas de navegación de archivos para adjuntar los archivos exactos a tu siguiente prompt, en lugar de describir las rutas a mano.

Adjuntos frente a archivos del proyecto (no confirmes lo que no es)

Happier admite adjuntos como parte del flujo de la sesión. Los adjuntos van muy bien para:

• pegar logs
• compartir archivos puntuales
• enviar artefactos para que el modelo los lea

…pero los adjuntos no son lo mismo que los archivos del proyecto que vas a confirmar.

Si lo que quieres es que "esto acabe en git", ponlo en el espacio de trabajo desde Archivos (Files) (crear / subir / editar), no como un adjunto temporal.

Solución de problemas

No veo Control de versiones ni los diffs en el móvil

Causas habituales:

• No se puede acceder a la máquina o al daemon dueño del repositorio.
• No estás conectado al mismo servidor o relay que tu máquina.

Si la sesión está inactiva pero la máquina está en línea, Happier puede cargar los datos del repositorio y de los archivos mediante las API de espacio de trabajo de la máquina, pero solo si de verdad puede llegar a esa máquina.

Faltan los botones de preparar o hacer commit

Las acciones de escritura de Git están detrás de un interruptor:

• Configuración (Settings) → Características (Features) → Git operations

Happier no me deja hacer push/pull/commit

Suele ser una regla de seguridad del repositorio haciendo su trabajo. Bloqueos típicos:

• hay conflictos
• HEAD separado
• la rama va por detrás del upstream

Resuelve el estado del repositorio desde un terminal completo y luego vuelve al flujo del móvil.

Puedo revisar diffs pero no hacer commit

Puede pasar si los datos de solo lectura del repositorio están disponibles pero las operaciones de escritura están desactivadas (interruptor apagado) o bloqueadas por el estado del repositorio.

En ese caso, un flujo práctico es:

• haz la revisión del diff y la limpieza en el móvil
• termina el commit y el push desde el terminal cuando vuelvas al portátil

Preguntas frecuentes

¿Puedo hacerlo desde un iPhone o un Android?

Sí. La diferencia principal es la comodidad.

• En el móvil, Happier usa pantallas centradas (lista → detalle) en lugar de una disposición de escritorio con varios paneles.
• En iOS o Android quizá prefieras revisar diffs y preparar cambios en el móvil, y resolver conflictos más tarde desde un terminal completo.

¿Por qué puedo revisar diffs pero no preparar ni hacer commit?

Dos motivos habituales:

1. Las operaciones de escritura de Git no están activadas. Activa Configuración (Settings) → Características (Features) → Git operations.
2. El repositorio está en un estado en el que las operaciones de escritura se bloquean a propósito (conflictos, HEAD separado, etc.).

¿Por qué está bloqueado el push?

Happier es prudente por diseño. El push suele bloquearse cuando:

• HEAD está separado
• la rama local va por detrás del upstream
• hay conflictos

En esos casos, plantea el flujo del móvil como: revisar + preparar + confirmar. Y haz push cuando hayas limpiado el estado del repositorio desde un terminal completo.

¿Tengo que hacer push desde el móvil?

No. Un flujo "primero el móvil" perfectamente razonable es:

• revisar diffs
• preparar con intención
• hacer commit

…y hacer push más tarde, cuando vuelvas al portátil (o cuando te parezca bien hacer una comprobación rápida en el terminal).

¿Y si no se puede acceder a mi máquina o al daemon?

Entonces no podrás cargar el estado de control de versiones del repositorio. En ese punto, tus opciones son:

• esperar a que la máquina vuelva a estar accesible, o
• volver a SSH o al escritorio remoto.

Happier no hace desaparecer los problemas de red o de disponibilidad de la máquina. Solo te facilita seguir con el flujo desde el móvil cuando la máquina está accesible.

Guías relacionadas

• Cómo usar Happier desde el móvil

Siguientes pasos

• Si lo que más te cuesta es la revisión de código, empieza por Cómo revisar diffs desde el móvil (es un flujo algo distinto al de hacer commit).
• Si te bloqueas siempre en el mismo paso (faltan los botones de commit o push, no se puede acceder al repositorio, etc.), conviértelo en una pequeña lista de comprobación para ti. Te ahorrará unos 10 minutos cada vez.