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, GitHub del trabajo, un Forgejo self-hosted… 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, está creando muchos “proyectos” con IA agéntica y usa Git como backend para versionado, mantenimiento, backup. Como cualquiera que empieza con Git, le está volviendo loco.

Tenía un script que me ayudaba con este tema, relacionado con mi antiguo apunte Git multicuenta. Lo que he hecho es evolucionarlo, mejorarlo y crear una Aplicación (en go) asequible para lo no técnicos. Es un proyecto open source, se llama Gitbox y resuelve exactamente ese problema: gestionar de forma sencilla múltiples cuentas y clones, sin que se pisen unas a otras.


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

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 evitarte su complejidad.

  • 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/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

Gitbox ofrece tres formas de interactuar, según tu estilo:

  • CLI — En Terminal, para power users, scripts y CI/CD. Comandos directos con gitbox <comando>.
  • TUI — En Terminal, con interfaz, ejecuta gitbox sin argumentos y se lanza una interfaz interactiva con dashboard, navegación por teclado y colores. Ideal para el día a día.
  • GUI — Aplicación de escritorio con Wails + Svelte. Tarjetas por cuenta, anillos de sincronización, gestión visual de mirrors y creación de repos con formularios.

Las tres interfaces comparten el mismo motor y 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