Integración con GitHub: Guía Completa
Aprende a conectar tus repositorios de GitHub y gestionar tu código directamente desde PocketCode en tu móvil.
Git y GitHub desde tu Móvil
Gestionar repositorios desde el móvil solía ser complicado. PocketCode trae Git integrado (la librería JGit, sin nada que instalar), así que el ciclo diario funciona desde tu teléfono: clonar, preparar, confirmar, subir y pull requests. Esta guía sigue las pantallas reales; la documentación de Git y GitHub explica cada una en detalle.
Configuración Inicial
1. Conectar tu Cuenta de GitHub
- Abre Ajustes → Integraciones → Servicios conectados y elige GitHub
- Toca Iniciar sesión con un código y luego Pedir un código a GitHub
- Toca Abrir GitHub, teclea el código que te muestra PocketCode en la página que se abre (
github.com/login/device) y apruébalo (flujo de dispositivo OAuth) - Deja la hoja abierta: se conecta sola cuando apruebas
No hay ningún token que copiar. El código dura unos 15 minutos; si caduca, pide otro. En el plan Free la primera cuenta de cada proveedor está incluida; conectar más es Pro.
2. Clonar un Repositorio
- Ve a Proyectos y toca Clonar
- Elige Clonar de GitHub (o GitLab / Bitbucket). Si aún no lo has conectado, toca Conectar primero
- Elige uno de tus repositorios (puedes buscarlos) y toca Clonar
El repositorio aparece como un proyecto nuevo. Si el nombre ya existe, el clon recibe un sufijo como repo (2). Clonas desde la lista de tus propios repositorios y solo por HTTPS: no se admiten remotos SSH ni clonar pegando una URL. El terminal local no tiene un programa git, así que ahí no existe git clone; usa el botón Clonar.
Flujo de Trabajo Básico
Hacer Cambios
- Edita archivos normalmente
- En un repositorio, el explorador de archivos marca los ficheros que cambiaron y la barra de estado muestra la rama con sus contadores ↑↓
- Abre Control de código (menú del editor → Git, o
Ctrl+Shift+Gcon un teclado físico, o toca el nombre de la rama en la barra de estado) y toca un fichero para ver su diff: las líneas añadidas y quitadas en una sola lista
Confirmar y Subir
En el editor:
- Abre Control de código
- Revisa los cambios y Prepara los ficheros que quieras (Preparar todo para todos, o Preparar por fragmentos para solo una parte de un fichero)
- Escribe un mensaje de commit y toca Confirmar
- Toca el icono Subir de la cabecera
El editor no muestra ningún mensaje de éxito ni de error tras un commit, un push o un pull: juzga el resultado por las listas y los contadores ↑↓. Si un push parece no hacer nada, repítelo desde Proyectos, que sí muestra el error.
Desde la tarjeta del proyecto en Proyectos también puedes tocar Commit, marcar los ficheros, escribir el mensaje y tocar Commit & Push (cuando el proyecto tiene remoto). Fija antes Tu nombre en los commits en Git.
El botón Mensaje con IA sugiere mensajes de commit en cuatro estilos, pero no es IA: es una sugerencia local, basada en reglas, que sale de los nombres de los ficheros que cambiaste, sin modelo ni clave.
Funciones Avanzadas
1. Gestión de Ramas
- Crear y cambiar: en la tarjeta del proyecto toca Git y luego Rama. Toca una rama para cambiar a ella, o Crear nueva rama. Estas filas aparecen cuando el proyecto tiene remoto (
origin); el Panel de Git del terminal también puede cambiar y crear ramas en local - Mezclar: en Control de código toca Fusionar, elige una de tus ramas locales y toca Mezclar en main (o la rama en la que estés)
- Comparar: Comparar muestra cuánto se separan dos ramas locales: commits por delante y por detrás, y ficheros cambiados
En estas listas solo aparecen ramas locales.
2. Pull Requests
Abre PR e issues de GitHub desde el menú Git del editor. Funciona con proyectos cuyo origin está en github.com y usa la cuenta que conectaste.
- Haz tus cambios en una rama
- Sube la rama (Subir cambios en la hoja Git del proyecto)
- En la pestaña PRs toca Nueva pull request desde …
- Rellena título y descripción, elige la rama base y la rama de origen (y márcala como borrador si quieres)
- Toca Crear pull request
La misma hoja tiene las pestañas Issues, CI y Avisos. Desde una pull request puedes fusionar (merge commit, squash o rebase), cerrarla y escribir un comentario.
3. Resolver Conflictos
PocketCode tiene un único resolvedor guiado de conflictos, y vive dentro del rebase interactivo: para cada bloque en conflicto eliges Ours, Theirs o Both. Con un merge o un pull que entra en conflicto no hay resolvedor: los marcadores (<<<<<<<, =======, >>>>>>>) se quedan en tus ficheros y el editor no te lista los ficheros en conflicto. Abre los ficheros afectados, quédate con la versión que quieras, quita los marcadores, y luego prepara y confirma.
4. Guardar Cambios Aparte (Stash)
Guarda cambios temporalmente desde Control de código: toca Guardar aparte y luego Guardar los cambios aparte. Toca una entrada para Aplicar, Recuperar o Descartar. Ten en cuenta que los ficheros nuevos (sin seguimiento) no se guardan, el mensaje del stash no se conserva y Recuperar siempre toma la entrada más reciente.
5. Rebase y Cherry-pick
El rebase interactivo (Pick, Reword, Squash, Fixup, Drop, con una copia restaurable) y el Cherry-pick (por hash de commit) se abren desde el menú ⋮ de la hoja de GitHub, y solo cuando el origin del proyecto está en github.com. En Proyectos → Git → Historial, al tocar un commit aparecen Revert, Reset Soft, Reset Hard y Cherry-pick. Reset Hard se ejecuta sin preguntar y descarta el trabajo sin confirmar.
Flujos de Trabajo Comunes
Flujo 1: Corrección Rápida
- En la tarjeta del proyecto abre Git → Rama y cambia a
main - Toca Bajar cambios para traer lo último
- Haz la corrección en el editor
- Toca Commit, escribe el mensaje y toca Commit & Push
Flujo 2: Nueva Funcionalidad
- Cambia a
main, toca Bajar cambios y luego Crear nueva rama (p. ej.feature/new-api) con el interruptor de cambiar activado - Desarrolla, confirmando a menudo desde Control de código
- Toca Subir cambios y luego Nueva pull request desde … en la hoja de GitHub
Flujo 3: Hotfix
- Cambia a tu rama de producción y crea
hotfix/critical-bug - Haz la corrección y confírmala
- Vuelve a la rama de producción, abre Control de código → Fusionar, elige la rama del hotfix y toca Mezclar en …
- Toca Subir cambios
Mejores Prácticas
Commits
✅ Buenos mensajes:
feat: add Google login
fix: correct email validation
docs: update README with instructions
refactor: simplify search function❌ Malos mensajes:
changes
fix
wip
asdfghRamas
Usa nombres descriptivos:
feature/nombre-funcionalidadfix/descripcion-bughotfix/problema-criticorefactor/nombre-refactor
Antes de Subir
- ✅ Revisa tus cambios
- ✅ Ejecuta tests (si existen)
- ✅ Baja primero los cambios remotos (evita conflictos)
- ✅ Escribe un mensaje descriptivo
Configuración Avanzada
Tu token y adónde va
- El token que obtienes con Iniciar sesión con un código se guarda cifrado en tu teléfono (AES-256-GCM con una clave del Android Keystore), por separado para cada cuenta de PocketCode y cada cuenta de proveedor
- Git lo envía solo a github.com, gitlab.com y bitbucket.org (coincidencia exacta del host). La hoja de GitHub lo envía a
api.github.comdirectamente desde tu teléfono. Un remoto en cualquier otro host (GitHub Enterprise, un GitLab propio, Gitea…) no recibe credenciales, así que los repositorios privados ahí fallan - Si inicias sesión en el propio PocketCode con GitHub, ese token de GitHub también se guarda, cifrado (AES-256-GCM), en el backend de PocketCode: el backend lo usa para listar tus repositorios y la app puede recuperarlo de ahí
.gitignore
Empezar a controlar este proyecto (tarjeta del proyecto → Git) crea un repositorio local con un .gitignore que deja fuera la carpeta .pocketcode/ de PocketCode. Añade tus propias reglas editando ese fichero:
# Dependencias
node_modules/
venv/
__pycache__/
# Salidas de build
dist/
build/
*.pyc
# Entorno
.env
.env.local
# IDE
.vscode/
.idea/
# SO
.DS_Store
Thumbs.dbLo que no se admite
- Remotos SSH (
git@…,ssh://): usa la dirección HTTPS - Git LFS (los ficheros quedan como pequeños punteros de texto), submódulos y firma de commits
- Hooks de Git: nunca se ejecutan
- Pull requests, issues, CI y avisos de GitLab, Bitbucket o GitHub Enterprise: necesitan un repositorio de github.com
- Las listas de la hoja de GitHub se cortan en 300 elementos
Colaboración
Code Review desde el Móvil
- Abre la PR
- Mira sus revisiones, checks y estado de aprobación
- Añade un comentario a la conversación de la PR
Enviar una revisión formal de aprobar/pedir cambios, y los comentarios anclados a una línea, aún no están conectados en la app: hazlo desde la web de GitHub. Lo que PocketCode muestra hoy es el estado de revisión de la PR y su conversación.
Discusiones
- Escribe comentarios en la conversación de la PR o del issue
- Menciona colaboradores con @usuario
Solución de Problemas
"No puedo hacer push"
Si la app dice "El remoto rechazó la subida. Baja primero los cambios remotos y vuelve a subir.":
- Toca Bajar cambios
- Resuelve los conflictos si los hay (mira arriba)
- Toca Subir cambios otra vez
"Cloné el repo pero no veo archivos"
Verifica:
- El clon es un proyecto nuevo en la página Proyectos: ábrelo desde ahí
- ¿Está vacío el repositorio?
- Los ficheros gestionados con Git LFS llegan como pequeños punteros de texto, no el contenido real
"Los cambios no aparecen en GitHub"
Un commit por sí solo no sube nada, y Publicar solo crea y vincula el repositorio vacío. Si la barra de estado muestra commits por delante (↑) o la tarjeta del proyecto dice Push, toca Subir cambios (o el icono Subir en Control de código).
Conclusión
Con PocketCode tienes el flujo diario de Git y GitHub en tu móvil. Ya no hay excusas para no hacer ese commit urgente.
Siguiente tutorial: Deploy automático desde GitHub con Vercel
¿Preguntas? Escribe a [email protected]
¡Happy coding! 🚀
Editor de código
Respuestas rápidas sobre esto
Sigue leyendo
- FuncionesControl de Versiones: Git Integrado en PocketCodeGit sin salir del editor: preparar, commit, ramas, merge, stash y pull requests de GitHub, integrado en PocketCode.6 min
- TutorialesDcoder cerró: qué usar en su lugar en AndroidDcoder cerró el 31 de marzo de 2026. Qué pasó y qué usar ahora en Android para Python, web o varios lenguajes, con los límites de cada opción.7 min
- TutorialesAplicaciones para programar en el celular en 2026: cuál usar para quéTermux, Acode, Pydroid 3, Replit, Spck y PocketCode: en qué es buena cada app para programar en el celular Android, cuánto cuesta y dónde se queda corta.5 min

