El objetivo es concreto:

• el repositorio se queda en el ordenador
• los cambios se pueden revisar desde el móvil
• puedes tomar una decisión (mantener / revertir / comentar / hacer commit)
• y puedes enviar cuando estés seguro

No porque "programar en el móvil" sea divertido.

Sino porque lo difícil de Git no es escribir código.

Es cuando estás lejos del teclado y aun así tienes que responder:

"¿Este cambio está bien?"

Esta guía explica un flujo que hace que revisar Git en remoto sea sencillo y repetible.

La contrapartida de fondo

Los flujos de Git en remoto siempre pagan uno de estos costes:

1. Montas un sistema de archivos (montajes SSH, proveedores de Archivos de iOS, etc.)
2. Te conectas en remoto a una interfaz (escritorio remoto)
3. Usas Git en la terminal (SSH/tmux)
4. Tienes una copia del repositorio en el móvil (un cliente Git móvil de verdad)

Todos pueden funcionar.

Pero en la práctica se sienten muy distintos.

Enfoques habituales y sus contrapartidas

• SSH desde el móvil: funciona, pero desplazarse por salidas largas en una terminal diminuta es un suplicio.
• Escritorio remoto: pesado y engorroso. Vale para emergencias, pero es una mala opción por defecto.
• Un cliente Git móvil que clona en local: también funciona, y si haces "desarrollo centrado en el iPad", puede ir muy bien. Un ejemplo conocido es Working Copy (Git en iOS). Es sólido. Pero no encaja cuando tu ordenador es la fuente de verdad y ya tiene el repositorio y las herramientas.

Lo que ayuda es un ciclo más ligero: revisar diffs, dejar comentarios, hacer commit y enviar, sin mover el repositorio al móvil.

Un flujo que funciona

Este flujo usa una interfaz remota sobre el ordenador que tiene el repositorio.

Happier es una opción compatible con ese enfoque.

Cada sesión de Happier está vinculada a una carpeta de tu ordenador. En el móvil, la sesión da a esa carpeta sus propias pestañas Archivos (Files) y Git, así que tienes archivos cambiados, diffs, commits e historial sin una copia del repositorio en el móvil.

Las acciones de escritura de Git (preparar, commit, traer, enviar) son experimentales y están desactivadas por defecto. Actívalas en Configuración (Settings) → Características (Features) → Operaciones de control de versiones (Source control operations) (consulta la documentación de Git (en inglés)). Ver el estado, los diffs y el historial funciona sin eso.

Contrapartida: sigue dependiendo de que el ordenador 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) que te permite mantener tus flujos de programación en un ordenador de confianza y gestionarlos desde el móvil.

Para empezar:

• 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

Paso a paso: usa el móvil como cliente Git remoto

1) Abre una sesión en la carpeta del repositorio

Abre una sesión que se ejecute en el repositorio, o inicia una nueva y elige la carpeta del repositorio en tu ordenador como directorio de trabajo.

2) Abre la pestaña Git

Dentro de la sesión, abre la pestaña Git y empieza por los archivos cambiados.

Esto te da tres cosas prácticas:

• una lista de archivos cambiados
• una vista de revisión de diffs
• una vista para hacer commit (con selección exacta de archivos para un commit desde la 0.2.12)

3) Revisa los diffs (sin releerlo todo)

En Archivos modificados (Changed files), verás:

• Archivos modificados (con un recuento)
• un botón ↓ Revisión (↓ Review)

Toca ↓ Revisión.

Si el repositorio es grande, puede que veas:

• Diff grande detectado (Large diff detected)

No es un bug. Es una barandilla: carga los diffs de forma progresiva en lugar de intentar mostrar 600 archivos en el móvil.

Mi ciclo real de revisión en el móvil

En el móvil, no intentes hacer una revisión perfecta.

Haz una pasada con límites:

1. Abre primero el archivo que parezca de más riesgo.
2. Decide: mantener / revertir / comentar.
3. Para.

La mayoría de los errores ocurren cuando la revisión deja de tener límites.

4) Usa comentarios de revisión para que los cambios sean precisos

Esta es la parte que muchas herramientas no resuelven bien.

Al revisar en el móvil, no quieres escribir un mensaje largo como:

"Por favor, arregla esa parte del diff."

En su lugar, deja comentarios de revisión por línea en el diff.

Así tienes una lista literal anclada a:

• la ruta del archivo
• la línea
• un fragmento del código de alrededor

También es una buena forma de "poner en cola" trabajo para más tarde.

5) Haz commit (cuando estés seguro)

En la parte inferior de Archivos modificados, verás:

• un resumen de la selección del commit (por ejemplo: 0 files selected for the next commit.)
• un botón Todo (All)
• un campo Mensaje de commit (Commit message)
• un botón Confirmar (Commit)

Un pequeño hábito que ayuda:

• no hagas commit de todo por defecto
• selecciona un conjunto pequeño y coherente de archivos
• escribe un mensaje de commit claro que describa la intención

Si la interfaz te dice algo como:

• Operation requires a clean working tree. (la operación requiere un árbol de trabajo limpio)

…tómatelo al pie de la letra.

Ese mensaje te dice "estás intentando ejecutar una operación que espera que el repositorio esté limpio".

6) Traer / Enviar (sincronizar con upstream)

En la pestaña Git verás acciones para:

• Traer (Pull)
• Enviar (Push)

Si usas Git en remoto desde el móvil, aquí es donde conviene ser deliberado.

Una buena regla:

• Traer sin problema.
• Enviar solo después de revisar el diff y estar seguro.

7) Usa el Historial cuando necesites contexto

Si intentas responder "¿qué ha pasado?" en lugar de "¿qué ha cambiado ahora mismo?", abre:

• el historial de commits de la pestaña Git

Es especialmente útil cuando revisas un repositorio en el móvil y has olvidado qué estabas haciendo ayer.

Terminal (opcional, para el 10 % de los casos)

A veces necesitas la terminal.

Las sesiones pueden mostrar una pestaña Terminal (CLI) (Terminal) cuando la terminal integrada está disponible. Es experimental según la matriz de funciones (en inglés).

Recomendación firme:

• mantén el flujo por defecto centrado en la interfaz (diffs, historial, commit)
• usa la terminal para los casos raros en que de verdad la necesites

Si usas la terminal para todo, vuelves a "SSH en el móvil", solo que con botones más bonitos.

Preguntas frecuentes

¿Esto es "Git en mi móvil" o "Git de mi ordenador desde el móvil"?

Lo segundo.

El repositorio se queda en el ordenador.

El móvil es la vista de revisión y control.

¿Cuál es un fallo grave típico?

Que el ordenador anfitrión se desconecte (reposo, tapa cerrada, cambios de red).

Ningún cliente Git remoto puede cambiar la física.

Lo que sí puedes hacer es que "¿está en línea?" sea evidente y evitar flujos que apliquen cambios a medias sin avisar.

¿Cuándo debería usar un cliente Git móvil de verdad?

Si de verdad quieres el repositorio en tu iPhone/iPad (trabajo sin conexión, viajes, desarrollo centrado en el iPad), usa un cliente Git móvil de verdad.

Herramientas como Working Copy existen por algo.

Esta guía es para el caso de "el ordenador tiene el repositorio y solo quiero revisar en remoto y hacer pequeñas intervenciones".

Guías relacionadas

• Cómo revisar diffs desde el móvil
• Cómo hacer commit desde el móvil