Git y GitHub
Del historial en tu carpeta al remoto en la nube: instalar, Git GUI, commits, ramas, pull requests y cómo salir de un conflicto sin romper el proyecto.
Git GUI: la ventana oficial de Git
Al instalar Git desde git-scm.com no solo llega la terminal: también se instala Git GUI (a veces aparece escrito «Git Gui»). Es la interfaz gráfica oficial del propio Git. No sustituye a GitHub Desktop ni a TortoiseGit; es otra forma de hablar con el mismo programa: ver qué archivos cambiaste, elegir cuáles van al próximo commit, escribir el mensaje, guardar la instantánea y, si quieres, enviarla al remoto.
Si entiendes esta ventana, el resto de clientes (Desktop, Tortoise, el panel de Cursor) solo cambian de botones. El ciclo sigue siendo el de siempre: editar → preparar (stage) → commit → push.
Cómo abrirla
- Windows: abre la carpeta del proyecto en el Explorador → clic derecho → Git GUI Here.
- Cualquier sistema: dentro de esa carpeta, en la terminal o en Git Bash, escribe
git gui. - Si la carpeta aún no es un repositorio, la pantalla inicial ofrece Create New Repository (equivale a
git init) o Clone Existing Repository (equivale agit clone).
Cómo está montada la ventana
Al abrir un repositorio que ya existe, la ventana principal se reparte en paneles. Los nombres van en inglés, como en el programa:
- Unstaged Changes (arriba a la izquierda). Lista de archivos modificados. Un clic en el icono a la izquierda del nombre pasa el archivo a Staged. Un clic en el nombre muestra el Diff a la derecha. Son dos acciones distintas: si solo pulsas el texto, no lo preparas para el commit.
- Staged Changes (abajo a la izquierda). Aquí está lo que entrará en la próxima instantánea. El mismo icono lo devuelve a Unstaged si te arrepientes.
- Diff (panel derecho). Comparación línea a línea. Conviene leerlo antes de hacer commit: así evitas colar un archivo a medias o un secreto por accidente.
- Commit Message (abajo). Escribe un mensaje claro, con verbo y motivo. El botón Commit solo responde si hay algo en Staged y el mensaje no está vacío. Sign Off añade una línea de autor; al empezar no hace falta.
Primer ciclo completo (commit + push)
Con la ventana abierta, el ritmo habitual es este:
- Edita y guarda el archivo en tu editor (Cursor, VS Code, Bloc de notas…).
- En Git GUI pulsa Rescan (o F5). Sin este paso la lista no se actualiza: Git GUI no vigila el disco al momento.
- Prepara el archivo (icono) o pulsa Stage Changed para marcar todos los modificados.
- Escribe el mensaje y pulsa Commit. Las listas se vacían: el commit ya está en tu disco, todavía no en GitHub.
- Push. Si es la primera vez: crea en GitHub un repositorio vacío; en Git GUI usa Remote → Add, nombre
origin, URL HTTPS del repo; después Push. Cuando pida contraseña, usa un Personal Access Token de GitHub, no la contraseña de la cuenta.
Menús que sí usarás
| Dónde | Qué hace |
|---|---|
| Repository → Explore Working Copy | Abre la carpeta del proyecto en el explorador. |
| Edit → Options… | Nombre, email y editor (como git config). |
| Commit → Stage Changed / Commit / Push | Los mismos botones de abajo, desde el menú. |
| Branch → Create… / Checkout… | Crear o cambiar de rama. |
| Merge → Local Merge… | Traer otra rama a la actual. |
| Remote → Fetch from / Push | Bajar o subir commits del remoto. |
| Repository → Visualize All Branch History | Abre gitk: historial gráfico de commits y ramas. |
Si algo falla
- No veo el archivo que acabo de guardar → Rescan.
- Commit no hace nada / botón inútil → no hay nada en Staged, o el mensaje está vacío.
- Clic en el nombre y no se stagea → hay que pulsar el icono de la izquierda.
- no configured push destination → falta el remoto: Remote → Add con la URL de GitHub.
- Push rejected → alguien empujó antes. Remote → Fetch from, luego Merge, resuelve conflictos si salen, y vuelve a Push.
- Authentication failed → hace falta un token de GitHub (Settings → Developer settings → Personal access tokens).
Cuando este ciclo te resulte natural, puedes mirar otras interfaces o pasar a los comandos del día a día en Flujo.
