Was ist Serie?
Serie ist eine Terminal-Oberfläche zum Durchstöbern der Historie eines Git-Repositories. Sie zeigt, was git log --graph --all zeigt — nur wird der Graph über das Inline-Bildprotokoll des Terminals gezeichnet statt mit ASCII-Kunst angenähert, sodass Branches und Merges auf einen Blick lesbar sind. Neben dem Graphen steht eine scroll- und durchsuchbare Commit-Liste mit Detailansicht. Serie ist bewusst ein Betrachter, kein Git-Client: es committet, branched und pusht nicht.
⚡ Hauptfunktionen von Serie
🖼️ Ein echter Commit-Graph
Der Graph wird über das Kitty- oder iTerm2-Protokoll als Bild gerendert, sodass Branch-Linien auch bei Dutzenden paralleler Branches lesbar bleiben.
🔍 Durchsuchbare Historie
Eine Commit-Liste neben dem Graphen, die scrollt und sucht, statt sich durch die Ausgabe von git log zu blättern.
📄 Detailansicht pro Commit
Einen Commit auswählen und Nachricht, Refs und Diff sehen, ohne den Graphen zu verlassen.
🎛️ Graph-Optionen
Chronologische oder topologische Sortierung, einfach oder doppelt breite Zellen, runde oder eckige Kanten — einmal auf der Kommandozeile oder in der Konfiguration gesetzt.
⌨️ Eigene Tastenbelegungen
? zeigt die aktuellen Belegungen, und jede davon lässt sich in config.toml überschreiben.
🧰 Eigene Befehle
Eigene Kommandos auf dem ausgewählten Commit ausführen: Ausgabe in einer eigenen Ansicht, etwas im Hintergrund starten oder Serie für ein interaktives Programm pausieren.
apt upgrade hält dich auf der neuesten Version.
📦 Installation aus deb.griffo.io
Schritt 1: Repository hinzufügen
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 update🆓 Es gibt einen für immer kostenlosen Spiegel. deb-free.griffo.io liefert Pakete für immer kostenlos — ohne Konto, ohne Abo, höchstens 2 Monate hinter Upstream, Sicherheitsfixes sofort. Derzeit enthält er cliamp, Ghostty, lazydocker, Oh My Posh und Zed; Serie ist nicht dabei, deshalb führt heute nur das Repository oben dorthin — auf Anfrage kann es aufgenommen werden.
Schritt 2: Serie installieren
# Neuestes Serie installieren
sudo apt install serie
# Installation überprüfen
serie --version# Neuestes Serie installieren
apt install serie
# Installation überprüfen
serie --versionSchritt 3: In einem Repository starten
# Serie liest das Repository im aktuellen Verzeichnis
cd /path/to/your/repo
serie
# Jederzeit ? drücken, um die Tastenbelegung zu sehen
# Erscheint kein Graph, das Bildprotokoll ausdrücklich angeben
serie -p kitty
# Die optionale Konfigurationsdatei für Tasten und Standardwerte
mkdir -p ~/.config/serie
$EDITOR ~/.config/serie/config.toml🎯 Grundlegende Verwendungsbeispiele
Historie durchstöbern:
# Die vollständige Historie des aktuellen Repositories
serie
# Nur die neuesten Commits, bei sehr großen Repositories
serie -n 5000
# Topologische statt chronologischer Reihenfolge
serie -o topo
# Mit HEAD statt dem neuesten Commit starten
serie -i headDen Graphen ans Terminal anpassen:
# Ein Bildprotokoll erzwingen, wenn die Erkennung danebenliegt
serie -p kitty
serie -p iterm
serie -p kitty-unicode
# Schmalere Graph-Zellen für ein kleines Fenster
serie -g single
# Eckige statt runder Kanten
serie -s angular
# Oder der großzügige, runde Look auf einem breiten Terminal
serie -g double -s roundedKonfiguration und Alltag:
# Die Konfigurationsdatei für Tasten und Standardwerte
mkdir -p ~/.config/serie
$EDITOR ~/.config/serie/config.toml
# Oder Serie auf eine Konfiguration anderswo zeigen lassen
SERIE_CONFIG_FILE=~/dotfiles/serie.toml serie
# Serie liest nur die Historie — git bleibt dein Client
git -C ~/src/project log --oneline -5
# Committen ist also weiterhin Sache von git
git commit -v🔧 Tool-Integrationen
Serie braucht zwei Dinge und arbeitet mit einem dritten zusammen:
- git: ein ganz normales Git-Repository und das
git-Binary, das das Paket als Abhängigkeit mitbringt - Dein Terminal: ein Emulator, der das Inline-Bildprotokoll von Kitty oder iTerm2 spricht — Ghostty, Kitty, WezTerm und iTerm2 gehören dazu
- Konfigurationsdatei:
$XDG_CONFIG_HOME/serie/config.tomloder das, woraufSERIE_CONFIG_FILEzeigt - Eigene Befehle:
git diff, einen Editor oder ein eigenes Skript auf eine Taste legen und auf dem ausgewählten Commit ausführen - Dein git-Client: Serie committet und pusht bewusst nicht und steht damit neben lazygit, GitUI oder purem git, statt sie zu ersetzen
🚀 Warum deb.griffo.io?
- Offizielles Ubuntu: paketiert Serie überhaupt nicht — auf einem Standardsystem gibt es nichts zu installieren
- cargo install --locked serie: aktuell, aber Rust-Toolchain und Kompilierlauf auf jeder Maschine, außerhalb von apt
- Upstream-Tarball: das offizielle Binary, für jedes Release von Hand neu geholt
- deb.griffo.io: neueste Version mit automatischen Updates
- ✅ Jung und in Bewegung: eigene Befehle, anpassbare Tasten und die Graph-Optionen kamen alle in normalen Releases — der aktuelle Build ist ein anderes Werkzeug als einer von vor einem Jahr
- ✅ Die einzige apt-Quelle: Serie ist weder in den Debian- noch in den Ubuntu-Archiven; dieses Repository paketiert den offiziellen Upstream-Build
- ✅ Automatische Updates: Pakete werden innerhalb von Stunden nach Upstream-Releases aktualisiert
- ✅ Ehrliche Paketierung: das Upstream-Binary unter
/usr/bin/serie, mitgitals Abhängigkeit; upstream liefert weder Handbuchseite noch Vervollständigungen, also erfindet das Paket keine - ✅ Zwei Architekturen: amd64 und arm64, beide statisch gelinkte musl-Builds ohne Bibliotheksabhängigkeiten
- ✅ Multi-Distribution: läuft auf Ubuntu 22.04, 24.04, 25.10 und 26.04
- ✅ Einfache Wartung: Updates mit den üblichen apt-Befehlen
📦 Paket-Build-Repository
Die Ubuntu-Pakete werden in diesem GitHub-Repository automatisch gebaut und gepflegt:
- 🌳 serie-debian - Builds der neuesten Releases
🔗 Verwandte Pakete
Ebenfalls verfügbar über deb.griffo.io:
- Ghostty - Terminal, das den Graphen über das Kitty-Protokoll zeichnet
- lazygit - Terminal-git-UI für das, was Serie bewusst auslässt
- Jujutsu - Git-kompatibles VCS mit erstklassigen Rebases
- Forgejo - Selbstgehostete Forge hinter der Historie, die du liest
git log --graph nur eine Wand aus Strichen und Sternchen produziert hat.