Logo Gitbox

Si usas agentes de IA o haces vibe coding, sabes lo rápido que se acumulan repositorios en distintas cuentas y proveedores. GitHub personal, del trabajo, o incluso un servidor casero como Forgejo… y de repente tienes decenas de repos clonados con la identidad equivocada, credenciales cruzadas y un lío monumental.

Eso le ha pasado a alguien muy cercano, una persona que no es técnica, que está creando muchos “proyectos” con IA agéntica y como cualquiera que empieza con Git, para versionado y backups, se está volviendo loco.

He creado Gitbox, para ayudar a los “no desarrolladores”, para gestionar de forma más sencilla múltiples cuentas y clones, sin que se pisen unas a otras. Si eres desarrollador míralo como otra alternativa y si te gusta pues adelante, en mi caso la uso en todos mis desktops o headless.


Arquitectura de Gitbox: cuentas, proveedores y flujo de trabajo
Arquitectura: cuentas y proveedores.

El problema

Cualquiera que trabaje con Git en varios contextos se ha encontrado con esto:

  • Clonas un repo del trabajo con tu cuenta personal y los commits salen con el email equivocado.
  • Tienes tokens y credenciales de tres proveedores distintos y no recuerdas cuál es cuál.
  • Cada vez que cambias de máquina (o formateas) hay que reconfigurar todo desde cero.
  • Con el auge del vibe coding y los agentes de IA, la cantidad de repos que manejas se multiplica y el problema se agrava.

La raíz del problema es que Git no fue diseñado para los no desarrolladores. Su modelo de configuración global (~/.gitconfig) asume que eres una sola persona, con un solo email y un solo método de autenticación, y aunque puede trabajar con multi cuenta y multi usuarios, tienes que ser un técnico o un desarrollador para no perderte.

Qué es Gitbox

Gitbox es una herramienta multiplataforma (Windows, macOS, Linux) que orquesta todo el ciclo de vida de tus cuentas Git y trata de evitarte su complejidad. Además se adapta a tu nivel: si no eres técnico usas la GUI (aplicación de escritorio con botones y formularios), y si eres desarrollador tienes la TUI (interfaz interactiva en terminal) o el CLI (comandos directos para scripts y automatización). Las tres comparten el mismo motor, así que eliges la que te resulte más cómoda.

  • Cuentas aisladas — facilita la gestión cuando trabajas con varias cuentas en varios proveedores y cada una tiene su identidad (nombre, email) y credenciales (Token, GCM o SSH), completamente separadas entre sí.
  • Descubrimiento automático — una vez que añades una cuenta, se conecta con el proveedor (GitHub, Forgejo, …) y lista todos tus repos para que te sea mas cómodo bajarlos (clonarlos).
  • Clonación inteligente — cada repo se clona con la identidad correcta en una estructura de carpetas organizada (por omisión en ~/00.git/[fuente]/[org]/[repo]). Dentro de cada clon, el fichero .git/config queda aislado y configurado con sus credenciales, para que no haya cruces.
  • Estado de sincronización — si tienes 10 o 20 clones nunca sabes cual está al día, tienes que ir uno a uno mirando. Con gitbox, de un vistazo ves qué repos están limpios, cuáles tienen cambios pendientes y cuáles están por detrás del remoto.
  • Pull seguro — si se puede, actualiza los repos que están por detrás usando la modalidad fast-forward, la más segura. Si un repo tiene conflictos o cambios locales, no lo toca.
  • Mirrors entre proveedores — para poder tener copias entre proveedores. Muy útil si tienes un servidor casero (por ejemplo forgejo o gitea) y quieres que ciertos repos se sincronicen automáticamente con uno de fuera (GitHub por ejemplo). Yo lo uso para tener copias de seguridad de algunos repos en otro proveedor..
  • Gestión sin edición - Gitbox nunca hace add, commit ni push por ti. Solo gestiona la infraestructura, qué cuentas tienes, y qué tienes clonado, cada uno con sus credenciales en su sitio correcto.

Instalación

Importante avisar sobre lo siguente, es una copia literal de un párrafo del propio README del proyecto:

Aviso

Gitbox no está firmado ni notarizado. Los binarios no tienen firma de código, así que macOS Gatekeeper, Windows SmartScreen y protecciones similares los marcarán como sospechosos. El instalador elimina estas marcas automáticamente (xattr -cr en macOS, Unblock-File en Windows) para que puedan ejecutarse. Al hacerlo estás confiando explícitamente en código sin firmar. Te recomiendo auditar el código fuente y el script de instalación antes de ejecutar nada. El proyecto es open source con licencia MIT — inspecciónalo, compílalo tú mismo, o no lo uses.

Aunque puedes descargar los binarios desde la página de Releases del proyecto, te recomiendo usar el script de instalación. Un solo comando que se encarga de la descarga, extracción, marcas de cuarentena y configuración del PATH. Ejecútalo desde un terminal (en windows desde Git Bash):

bash <(curl -fsSL https://raw.githubusercontent.com/LuisPalacios/gitbox/main/scripts/bootstrap.sh)

El instalador soporta opciones adicionales, añade --help al final para verlas.

En macOS el CLI se instala en ~/bin/gitbox y la GUI en /Applications/GitboxApp.app. En Linux y Windows ambos van a ~/bin/. El script añade ~/bin al PATH si es necesario.

Requisitos:

  • Git 2.39+ - Instalador para Windows (Incluye Git Bash), MacOS y Linux.
  • Git Credential Manager. Muy recomendado para configurar credenciales de tipo GCM.
  • En macOS importante usar una versión mejor que la que viene con el sistema. Recomiendo tener Homebrew e instalar Git y GCM (brew install git y brew install --cask git-credential-manager).

Tres interfaces

Como decía, Gitbox se adapta a tu nivel. Aquí va el detalle de cada interfaz y cuándo tiene más sentido usar cada una:

  • GUI — La opción ideal si no eres técnico o simplemente prefieres trabajar con ratón. Es una aplicación de escritorio (Wails + Svelte) con tarjetas por cuenta, anillos de sincronización, gestión visual de mirrors y formularios para crear repos. Todo a golpe de clic.
  • TUI — Para quienes viven en el terminal pero quieren algo visual. Ejecuta gitbox sin argumentos y obtienes un dashboard interactivo con navegación por teclado y colores. Ideal para el día a día de un desarrollador.
  • CLI — Para power users, scripts y automatización. Comandos directos con gitbox <comando>, perfecto para integrar en flujos CI/CD o en tus propios scripts.

Las tres comparten la misma configuración (~/.config/gitbox/gitbox.json), así que puedes alternar entre ellas sin problema.

Mirrors y backups

Una funcionalidad que me parece clave es la posibilidad de crear mirrors entre proveedores. De momento está probado para hacerlo entre un servidor self-hosted (por ejemplo Forgejo) y GitHub.

Esto crea copias de seguridad automáticas en el otro proveedor. Si mañana GitHub decide cambiar sus condiciones o simplemente quiero tener redundancia, mis repos están a salvo.

Conclusión

Si trabajas con múltiples cuentas de Git — ya sea por tener proyectos personales y profesionales, o porque la explosión del vibe coding con agentes de IA te ha llenado de repos en distintos proveedores — Gitbox te ahorra horas de configuración manual y errores de identidad. Lo uso a diario y es liberador no tener que pensar en credenciales cada vez que clono algo.

Enlaces interesantes