¿Qué es Serie?
Serie es una interfaz de terminal para recorrer el historial de un repositorio Git. Muestra lo mismo que git log --graph --all, pero el grafo se dibuja con el protocolo de imágenes del emulador de terminal en lugar de aproximarse con arte ASCII, así que ramas y fusiones se leen de un vistazo. Junto al grafo hay una lista de commits que se recorre y se busca, con una vista de detalle. Es deliberadamente un visor, no un cliente Git: no hace commit, ni ramas, ni push.
⚡ Funciones clave de Serie
🖼️ Un grafo de commits de verdad
El grafo se renderiza como imágenes mediante el protocolo de Kitty o iTerm2, así que las líneas de rama siguen siendo legibles con decenas de ramas en paralelo.
🔍 Historial con búsqueda
Una lista de commits junto al grafo que se desplaza y se busca, en lugar de paginar la salida de git log.
📄 Vista de detalle
Selecciona un commit y verás su mensaje, sus refs y su diff sin salir del grafo.
🎛️ Opciones del grafo
Orden cronológico o topológico, celdas de ancho simple o doble, aristas redondeadas o angulares: se fija en la línea de comandos o en la configuración.
⌨️ Atajos personalizables
? muestra los atajos actuales, y todos se pueden redefinir en config.toml.
🧰 Comandos de usuario
Ejecuta tus propios comandos sobre el commit seleccionado: en una vista dedicada, en segundo plano, o suspendiendo Serie para algo interactivo.
apt upgrade te mantiene en la última versión.
📦 Instalación desde deb.griffo.io
Paso 1: Añadir el repositorio
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Existe un espejo gratis para siempre. deb-free.griffo.io sirve paquetes gratis para siempre: sin cuenta, sin suscripción, como máximo 2 meses por detrás del upstream, correcciones de seguridad inmediatas. Ahora mismo incluye cliamp, Ghostty, lazydocker, Oh My Posh y Zed; Serie no está entre ellas, así que hoy el repositorio de arriba es la única forma de instalarlo — pídelo y puede añadirse.
🧩 Sobre la opción extrepo. extrepo es la herramienta propia de Debian para repositorios externos: escribe el archivo de sources e instala la clave de firma por ti, comprobándola antes contra metadatos firmados. Este repositorio está registrado en ella como griffo, y el espejo gratuito para siempre como griffo-free, así que en Debian (bookworm, trixie, forky y sid) los comandos de arriba son toda la configuración.
extrepo solo configura el archivo de sources y la clave: las credenciales de una suscripción siguen yendo en /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu no está cubierto, porque extrepo publica metadatos solo para las suites de Debian: allí usa los comandos con sudo o como root.
Paso 2: Instalar Serie
# Instalar la última versión de Serie
sudo apt install serie
# Verificar la instalación
serie --version# Instalar la última versión de Serie
apt install serie
# Verificar la instalación
serie --versionPaso 3: Ejecutarlo en un repositorio
# Serie lee el repositorio del directorio actual
cd /path/to/your/repo
serie
# Pulsa ? en cualquier momento para ver los atajos
# Si no aparece el grafo, indica el protocolo de imagen explícitamente
serie -p kitty
# El archivo de configuración opcional, para atajos y valores por defecto
mkdir -p ~/.config/serie
$EDITOR ~/.config/serie/config.toml🎯 Ejemplos básicos de uso
Recorrer el historial:
# El historial completo del repositorio actual
serie
# Solo los commits más recientes, en repositorios muy grandes
serie -n 5000
# Orden topológico en vez de cronológico
serie -o topo
# Empezar con HEAD seleccionado en lugar del commit más nuevo
serie -i headAjustar el grafo a tu terminal:
# Forzar un protocolo de imagen si la detección se equivoca
serie -p kitty
serie -p iterm
serie -p kitty-unicode
# Celdas del grafo más estrechas para una ventana pequeña
serie -g single
# Aristas angulares en vez de redondeadas
serie -s angular
# O el aspecto amplio y redondeado en una terminal ancha
serie -g double -s roundedConfiguración y uso diario:
# El archivo de configuración, para atajos y valores por defecto
mkdir -p ~/.config/serie
$EDITOR ~/.config/serie/config.toml
# O apuntar Serie a una configuración en otro sitio
SERIE_CONFIG_FILE=~/dotfiles/serie.toml serie
# Serie solo lee el historial: git sigue siendo tu cliente
git -C ~/src/project log --oneline -5
# Así que hacer commit sigue siendo tarea de git
git commit -v🔧 Integraciones con otras herramientas
Serie necesita dos cosas y colabora con una tercera:
- git: un repositorio Git normal y el binario
git, que el paquete instala como dependencia - Tu terminal: un emulador que hable el protocolo de imágenes de Kitty o iTerm2: Ghostty, Kitty, WezTerm e iTerm2 valen
- Archivo de configuración:
$XDG_CONFIG_HOME/serie/config.toml, o lo que apunteSERIE_CONFIG_FILE - Comandos de usuario: asigna
git diff, un editor o tu propio script a una tecla y ejecútalo sobre el commit seleccionado - Tu cliente git: Serie no hace commit ni push a propósito, así que convive con lazygit, GitUI o git a secas en vez de sustituirlos
🚀 ¿Por qué elegir deb.griffo.io?
- Debian oficial: no empaqueta Serie: un sistema recién instalado no tiene nada que instalar
- cargo install --locked serie: actualizado, pero exige toolchain de Rust y compilar en cada máquina, fuera de apt
- Tarball upstream: el binario oficial, descargado a mano en cada versión
- deb.griffo.io: última versión con actualizaciones automáticas
- ✅ Joven y en movimiento: los comandos de usuario, los atajos personalizables y las opciones del grafo llegaron en versiones normales: la compilación actual es otra herramienta comparada con una de hace un año
- ✅ La única fuente apt: Serie no está ni en los archivos de Debian ni en los de Ubuntu; este repositorio empaqueta la compilación oficial upstream
- ✅ Actualizaciones automáticas: los paquetes se actualizan pocas horas después de cada versión upstream
- ✅ Empaquetado honesto: el binario upstream en
/usr/bin/serie, congitcomo dependencia; upstream no publica página de manual ni completaciones, así que el paquete no se las inventa - ✅ Dos arquitecturas: amd64 y arm64, ambas compilaciones estáticas con musl y sin dependencias
- ✅ Multidistribución: funciona en Bookworm, Trixie, Forky y Sid
- ✅ Mantenimiento sencillo: actualizaciones con los comandos apt de siempre
📦 Repositorio de compilación del paquete
Los paquetes de Debian se compilan y mantienen automáticamente en este repositorio de GitHub:
- 🌳 serie-debian - Compilaciones de las últimas versiones
🔗 Paquetes relacionados
También disponibles en deb.griffo.io:
- Ghostty - Terminal que dibuja el grafo mediante el protocolo de Kitty
- lazygit - Interfaz git de terminal para lo que Serie omite a propósito
- Jujutsu - VCS compatible con Git y rebases de primera clase
- Forgejo - Forja autoalojada detrás del historial que estás leyendo
git log --graph te devolvió un muro de barras y asteriscos ilegible.