Instalar GitComet - Guía Completa y Verificada

Aprende a instalar y configurar GitComet, la interfaz gráfica Git más rápida en Rust (Local-First, AGPL-3.0). Incluye instrucciones para Windows, macOS, Linux, prerrequisitos, configuración difftool/mergetool, seguridad y troubleshooting.

Introducción

GitComet es la interfaz gráfica de usuario (GUI) más rápida para flujos de trabajo Git, construida end-to-end en Rust con enfoque local-first. Diseñada específicamente para equipos que requieren operaciones locales eficientes en repositorios grandes como Chromium.

Versión actual: v0.2.6 (2026-09-26) | Licencia: AGPL-3.0

Prerrequisitos del Sistema

Componente	Requerimiento Mínimo	Recomendado
Sistema Operativo	Linux, Windows 10+, macOS 10.15+	Linux moderno, Windows 11, macOS Sonoma+
Git	Versión 2.53+	Versión 2.50+ (recomendado)
RAM	4 GB	8 GB para repositorios grandes
CPU	2 núcleos	4 núcleos para rendimiento óptimo

⚠️ Importante: GitComet requiere Git 2.53+ para compatibilidad completa. Con versiones anteriores, la aplicación mostrará un aviso y algunas características (como mantenimiento de repositorios) estarán desactivadas.

Verificar versión de Git

git --version

Debería mostrar: git version 2.53.x o superior.

Instalación en Windows

Opción 1: Microsoft Store (Recomendado)

winget install gitcomet

Esta es la forma más sencilla y segura de instalar GitComet en Windows. El instalador se descarga automáticamente desde GitHub Releases.

Opción 2: GitHub Releases (.exe)

Descarga el instalador desde GitHub Releases
Ejecuta el archivo .exe como administrador
Sigue el asistente de instalación

Opción 3: Portable (Sin instalación)

Descarga el binario portable desde GitHub Releases y ejecútalo directamente sin instalar.

⚠️ Nota: Homebrew no está disponible nativamente en Windows. Para usarlo, necesitas WSL (Windows Subsystem for Linux).

Instalación en macOS

Opción 1: Homebrew (Recomendado)

brew install --cask gitcomet

Homebrew instala el paquete AppImage por defecto. Si tu sistema no puede ejecutar AppImages, usa las opciones alternativas.

Opción 2: GitHub Releases (.dmg)

Descarga el instalador .dmg desde GitHub Releases
Abre el archivo .dmg
Arrastra GitComet a la carpeta Applications

Opción 3: App Store Oficial

Disponible en la Mac App Store de Apple con verificación de seguridad integrada.

Instalación en Linux

AUR (Arch Linux) - Recomendado

git clone https://aur.archlinux.org/gitcomet-bin.git
cd gitcomet-bin && makepkg -si

El paquete AUR repackea automáticamente las releases de GitHub.

APT (Debian/Ubuntu) - Repositorio Oficial

curl -fsSL https://apt.gitcomet.dev/gitcomet-archive-keyring.gpg | sudo tee /usr/share/keyrings/gitcomet-archive-keyring.gpg > /dev/null
curl -fsSL https://apt.gitcomet.dev/gitcomet.sources | sudo tee /etc/apt/sources.list.d/gitcomet.sources > /dev/null
sudo apt update
sudo apt install gitcomet

⚠️ Librerías de runtime: Si instalas un tarball o Homebrew binary en Debian/Ubuntu/WSLg, instala las librerías del runtime GUI por separado:

sudo apt install libxcb1 libxkbcommon0 libxkbcommon-x11-0 libvulkan1 libegl1 libwayland-client0 libwayland-egl1

Flatpak

flatpak install flathub com.gitcomet.GitComet

AppImage (Universal)

Descarga el AppImage desde GitHub Releases y ejecútalo directamente:

chmod +x gitcomet-v0.2.6-linux-x86_64.AppImage
gitcomet-v0.2.6-linux-x86_64.AppImage

RPM (Fedora)

sudo dnf install ./gitcomet-<version>-1.x86_64.rpm

⚠️ Compatibilidad: El RPM soporta Fedora 42+ y necesita glibc 2.35+. RHEL 9 (glibc 2.34) no puede instalarlo.

Configuración como Difftool/Mergetool

Método 1: Usar el comando setup (Recomendado)

gitcomet setup

Este comando configura automáticamente Git para usar GitComet como difftool y mergetool tanto en modo headless como GUI.

Opciones de configuración:

--local: Configura solo el repositorio actual (no global)
--dry-run: Muestra los comandos antes de aplicarlos

Método 2: Configuración Manual

# Configura Git globalmente
git config --global core.diffTool gitcomet

# O configura solo para el repositorio actual
git config diff.tool gitcomet

Configuración de Difftool/Mergetool Integrado

GitComet soporta ambos modos:

Modo	Descripción	Cuándo usar
`gitcomet`	Headless (algoritmo solo)	CI/CD, scripts, entornos sin display
`gitcomet-gui`	GUI interactiva	Uso interactivo con ventana de GitComet

Auto-selección automática: La configuración incluye guiDefault=auto, por lo que Git elige automáticamente el modo GUI cuando hay DISPLAY disponible, y headless de otra forma.

Verificación Posterior a la Instalación

1. Verificar que GitComet está en PATH

which gitcomet

Debería mostrar la ruta completa al ejecutable.

2. Verificar configuración de Git

git config --global diff.tool
git config --global mergetool.trustExitCode
git config --global difftool.prompt

3. Probar con un repositorio de prueba

# Crea un repositorio de prueba
cd /tmp && mkdir test-repo && cd test-repo
git init
echo "test" > file.txt
git add .
git commit -m "Initial commit"

# Modifica el archivo
echo "modified" >> file.txt
git diff HEAD~1 -- file.txt

Git debería abrir GitComet para mostrar las diferencias.

Actualización y Backup

Actualizar GitComet

Plataforma	Método de Actualización
Windows (Store)	Actualiza desde Microsoft Store
macOS (Homebrew)	`brew upgrade gitcomet`
Linux (APT)	`sudo apt update && sudo apt upgrade gitcomet`
AUR	`makepkg -si --force`

Exportar Configuración (Backup)

git config --list --local > gitcomet-config-local.txt
git config --global --list > gitcomet-config-global.txt

Importar Configuración

git config --local --file gitcomet-config-local.txt
git config --global --file gitcomet-config-global.txt

Rollback y Desinstalación Segura

Desinstalar GitComet

gitcomet uninstall

Este comando elimina la integración con Git de forma segura.

Comandos idempotentes: Los comandos setup y uninstall están diseñados para ser idempotentes. Puedes ejecutarlos múltiples veces sin efectos secundarios.

Desinstalar por Plataforma

Plataforma	Comando de Desinstalación
Windows (Store)	`winget uninstall gitcomet`
macOS (Homebrew)	`brew uninstall --cask gitcomet`
Linux (APT)	`sudo apt remove gitcomet`
AUR	`makepkg -Ri`

Errores Habituales y Soluciones

Error: "gitcomet: command not found"

Causa: GitComet no está en PATH o no se instaló correctamente.

Solución:

# Verificar instalación
which gitcomet

# Si no existe, reinstalar según tu plataforma

Error: "Git version too old"

Causa: Git 2.53+ requerido no está instalado.

Solución:

# Windows
winget upgrade git

# macOS
brew upgrade git

# Linux (Ubuntu/Debian)
sudo apt update && sudo apt install git

Error: "No DISPLAY variable set"

Causa: GitComet intenta abrir GUI sin entorno gráfico.

Solución:

# En servidores o SSH
export DISPLAY=:0
gitcomet difftool --local <path> --remote <path>

Error: "Vulkan/EGL not available"

Causa: Librerías de renderizado no instaladas en Linux.

Solución:

sudo apt install libvulkan1 libegl1 libwayland-client0

Error: "Commit signature verification failed"

Causa: GPG/X.509/SSH no configurado para firmas.

Solución:

# Configurar GPG
gpg --gen-key

# O usar SSH
git config commit.gpgsign true

Seguridad y Privacidad

Enfoque Local-First

✅ Garantizado: Tus repositorios permanecen en tu máquina. No hay cuentas requeridas, sincronización externa ni subida de datos.

Código Abierto Auditable

Licencia: AGPL-3.0 con código fuente auditable en GitHub.

Verificación de Firmas

Opciones disponibles: GPG, X.509 o SSH para verificar la autenticidad del código.

⚠️ Sin soporte Docker: GitComet no incluye archivos Dockerfile ni soporte de contenerización nativa.

Preguntas Frecuentes (FAQ)

Q: ¿GitComet requiere internet?

A: No, funciona local-first sin sincronización externa. Solo necesita conexión para descargar las actualizaciones de la aplicación.

Q: ¿Es compatible con repositorios grandes?

A: Sí, diseñado específicamente para Chromium y monorepos masivos. Abre repositorios como Chromium en ~1s vs 18-25s de GitKraken.

Q: ¿Puedo usarlo como difftool?

A: Sí, en modos headless o GUI invocable por git difftool/mergetool. Soporta KDiff3 y Meld.

Q: ¿Cuál es la licencia?

A: AGPL-3.0 (código abierto con cláusula de copyleft). Garantiza transparencia total en el desarrollo.

Q: ¿Funciona en WSL?

A: Sí, pero necesitas instalar las librerías de runtime adicionales para la interfaz gráfica.

Q: ¿Puedo usar GitComet sin instalarlo?

A: Sí, descarga el binario portable desde GitHub Releases y ejecútalo directamente.

Alternativas Reales

Herramienta	Licencia	Precio	GitHub Stars
GitComet	AGPL-3.0	Gratis (€0)	897
GitButler	FSL-1.1-MIT	Gratis	21,781
GitHub Desktop	MIT	Gratis	45,000+
GitKraken	Propietario	Pago	21,781

Instalar GitComet - Guía Completa y Verificada

Introducción

Prerrequisitos del Sistema

Verificar versión de Git

Instalación en Windows

Opción 1: Microsoft Store (Recomendado)

Opción 2: GitHub Releases (.exe)

Opción 3: Portable (Sin instalación)

Instalación en macOS

Opción 1: Homebrew (Recomendado)

Opción 2: GitHub Releases (.dmg)

Opción 3: App Store Oficial

Instalación en Linux

AUR (Arch Linux) - Recomendado

APT (Debian/Ubuntu) - Repositorio Oficial

Flatpak

AppImage (Universal)

RPM (Fedora)

Configuración como Difftool/Mergetool

Método 1: Usar el comando setup (Recomendado)

Método 2: Configuración Manual

Configuración de Difftool/Mergetool Integrado

Verificación Posterior a la Instalación

1. Verificar que GitComet está en PATH

2. Verificar configuración de Git

3. Probar con un repositorio de prueba

Actualización y Backup

Actualizar GitComet

Exportar Configuración (Backup)

Importar Configuración

Rollback y Desinstalación Segura

Desinstalar GitComet

Desinstalar por Plataforma

Errores Habituales y Soluciones

Error: "gitcomet: command not found"

Error: "Git version too old"

Error: "No DISPLAY variable set"

Error: "Vulkan/EGL not available"

Error: "Commit signature verification failed"

Seguridad y Privacidad

Enfoque Local-First

Código Abierto Auditable

Verificación de Firmas

Preguntas Frecuentes (FAQ)

Q: ¿GitComet requiere internet?

Q: ¿Es compatible con repositorios grandes?

Q: ¿Puedo usarlo como difftool?

Q: ¿Cuál es la licencia?

Q: ¿Funciona en WSL?

Q: ¿Puedo usar GitComet sin instalarlo?

Alternativas Reales

Recursos Adicionales

Fuentes verificadas

Fuentes verificadas