Qu'est-ce que Serie ?
Serie est une interface terminal pour parcourir l'historique d'un dépôt Git. Elle montre ce que montre git log --graph --all, mais le graphe est dessiné avec le protocole d'images en ligne de l'émulateur de terminal au lieu d'être approximé en art ASCII : branches et fusions se lisent d'un coup d'œil. À côté du graphe, une liste de commits défilante et cherchable, avec une vue de détail. C'est délibérément une visionneuse, pas un client Git : elle ne commite pas, ne crée pas de branches et ne pousse pas.
⚡ Fonctionnalités clés de Serie
🖼️ Un vrai graphe de commits
Le graphe est rendu en images via le protocole Kitty ou iTerm2 : les lignes de branches restent lisibles même avec des dizaines de branches parallèles.
🔍 Historique cherchable
Une liste de commits à côté du graphe, qui défile et se cherche, au lieu de paginer la sortie de git log.
📄 Vue de détail
Sélectionnez un commit pour voir son message, ses références et son diff sans quitter le graphe.
🎛️ Options de graphe
Ordre chronologique ou topologique, cellules simple ou double largeur, arêtes arrondies ou angulaires — en ligne de commande ou dans la configuration.
⌨️ Raccourcis personnalisables
? affiche les raccourcis courants, et tous se redéfinissent dans config.toml.
🧰 Commandes utilisateur
Lancez vos propres commandes sur le commit sélectionné : dans une vue dédiée, en arrière-plan, ou en suspendant Serie pour un programme interactif.
apt upgrade vous maintient à jour.
📦 Installation depuis deb.griffo.io
Étape 1 : ajouter le dépôt
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🆓 Il existe un miroir gratuit pour toujours. deb-free.griffo.io distribue des paquets gratuitement pour toujours — sans compte, sans abonnement, au plus 2 mois derrière l'upstream, correctifs de sécurité immédiats. Il contient aujourd'hui cliamp, Ghostty, lazydocker, Oh My Posh et Zed ; Serie n'en fait pas partie, le dépôt ci-dessus reste donc le seul moyen de l'installer — demandez-le et il pourra y être ajouté.
🧩 À propos de l'option extrepo. extrepo est l'outil de Debian pour les dépôts externes : il écrit le fichier de sources et installe la clé de signature à votre place, après l'avoir vérifiée face à des métadonnées signées. Ce dépôt y est enregistré sous le nom griffo, et le miroir gratuit à vie sous griffo-free ; sur Debian (bookworm, trixie, forky et sid), les commandes ci-dessus constituent donc toute l'installation.
extrepo ne met en place que le fichier de sources et la clé : les identifiants d'un abonnement vont toujours dans /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu n'est pas couvert, car extrepo ne publie de métadonnées que pour les suites Debian : utilisez-y les commandes avec sudo ou en root.
Étape 2 : installer Serie
# Installer le dernier Serie
sudo apt install serie
# Vérifier l'installation
serie --version# Installer le dernier Serie
apt install serie
# Vérifier l'installation
serie --versionÉtape 3 : le lancer dans un dépôt
# Serie lit le dépôt du répertoire courant
cd /path/to/your/repo
serie
# Appuyez sur ? à tout moment pour voir les raccourcis
# Si le graphe n'apparaît pas, nommez explicitement le protocole d'images
serie -p kitty
# Le fichier de configuration optionnel, pour raccourcis et valeurs par défaut
mkdir -p ~/.config/serie
$EDITOR ~/.config/serie/config.toml🎯 Exemples d'utilisation de base
Parcourir l'historique :
# L'historique complet du dépôt courant
serie
# Seulement les commits récents, pour un très gros dépôt
serie -n 5000
# Ordre topologique plutôt que chronologique
serie -o topo
# Démarrer avec HEAD sélectionné plutôt que le commit le plus récent
serie -i headAdapter le graphe à votre terminal :
# Forcer un protocole d'images quand la détection se trompe
serie -p kitty
serie -p iterm
serie -p kitty-unicode
# Des cellules de graphe plus étroites pour une petite fenêtre
serie -g single
# Des arêtes angulaires plutôt qu'arrondies
serie -s angular
# Ou l'affichage large et arrondi sur un terminal spacieux
serie -g double -s roundedConfiguration et usage quotidien :
# Le fichier de configuration, pour raccourcis et valeurs par défaut
mkdir -p ~/.config/serie
$EDITOR ~/.config/serie/config.toml
# Ou pointer Serie vers une configuration ailleurs
SERIE_CONFIG_FILE=~/dotfiles/serie.toml serie
# Serie ne fait que lire l'historique — git reste votre client
git -C ~/src/project log --oneline -5
# Committer reste donc l'affaire de git
git commit -v🔧 Intégrations avec d'autres outils
Serie a besoin de deux choses et coopère avec une troisième :
- git : un dépôt Git ordinaire et le binaire
git, que le paquet installe comme dépendance - Votre terminal : un émulateur qui parle le protocole d'images de Kitty ou d'iTerm2 — Ghostty, Kitty, WezTerm et iTerm2 conviennent
- Fichier de configuration :
$XDG_CONFIG_HOME/serie/config.toml, ou ce que désigneSERIE_CONFIG_FILE - Commandes utilisateur : associez
git diff, un éditeur ou votre script à une touche et exécutez-le sur le commit sélectionné - Votre client git : Serie ne commite ni ne pousse volontairement : elle accompagne lazygit, GitUI ou git tout court au lieu de les remplacer
🚀 Pourquoi choisir deb.griffo.io ?
- Debian officiel : n'empaquette pas Serie — un système standard n'a rien à installer
- cargo install --locked serie : à jour, mais il faut une chaîne Rust et une compilation sur chaque machine, hors d'apt
- Archive upstream : le binaire officiel, à retélécharger à la main à chaque version
- deb.griffo.io : dernière version avec mises à jour automatiques
- ✅ Jeune et en mouvement : commandes utilisateur, raccourcis personnalisables et options de graphe sont arrivés dans des versions ordinaires : la version courante n'est plus le même outil qu'il y a un an
- ✅ La seule source apt : Serie n'est ni dans les archives Debian ni dans celles d'Ubuntu ; ce dépôt empaquette la construction officielle upstream
- ✅ Mises à jour automatiques : les paquets sont mis à jour quelques heures après chaque version upstream
- ✅ Empaquetage honnête : le binaire upstream dans
/usr/bin/serie, avecgitdéclaré en dépendance ; upstream ne fournit ni page de manuel ni complétions, le paquet n'en invente donc pas - ✅ Deux architectures : amd64 et arm64, deux builds musl statiques sans dépendances
- ✅ Multi-distribution : fonctionne sur Bookworm, Trixie, Forky et Sid
- ✅ Maintenance simple : des mises à jour avec les commandes apt habituelles
📦 Dépôt de construction du paquet
Les paquets Debian sont construits et maintenus automatiquement dans ce dépôt GitHub :
- 🌳 serie-debian - Constructions des dernières versions
🔗 Paquets associés
Également disponibles sur deb.griffo.io :
- Ghostty - Terminal qui dessine le graphe via le protocole Kitty
- lazygit - Interface git en terminal pour ce que Serie laisse de côté
- Jujutsu - VCS compatible Git avec des rebases de premier ordre
- Forgejo - Forge auto-hébergée derrière l'historique que vous lisez
git log --graph vous a servi un mur de barres et d'astérisques illisible.