O que é o Serie?
O Serie é uma interface de terminal para navegar pelo histórico de um repositório Git. Ele mostra o que o git log --graph --all mostra, mas o grafo é desenhado com o protocolo de imagens do emulador de terminal em vez de ser aproximado em arte ASCII — então branches e merges são legíveis de relance. Ao lado do grafo há uma lista de commits que rola e é pesquisável, com uma visão de detalhe. É deliberadamente um visualizador, não um cliente Git: não faz commit, branch nem push.
⚡ Principais recursos do Serie
🖼️ Um grafo de commits de verdade
O grafo é renderizado como imagens pelo protocolo do Kitty ou do iTerm2, então as linhas de branch continuam legíveis com dezenas de branches em paralelo.
🔍 Histórico pesquisável
Uma lista de commits ao lado do grafo que rola e busca, em vez de paginar a saída do git log.
📄 Visão de detalhe
Selecione um commit e veja mensagem, refs e diff sem sair do grafo.
🎛️ Opções do grafo
Ordem cronológica ou topológica, células de largura simples ou dupla, arestas arredondadas ou angulares — na linha de comando ou na configuração.
⌨️ Atalhos personalizáveis
? mostra os atalhos atuais, e todos podem ser redefinidos em config.toml.
🧰 Comandos de usuário
Rode seus próprios comandos sobre o commit selecionado: numa visão dedicada, em segundo plano ou suspendendo o Serie para algo interativo.
apt upgrade mantém você na versão mais recente.
📦 Instalação a partir do deb.griffo.io
Passo 1: Adicionar o repositório
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🆓 Existe um espelho grátis para sempre. deb-free.griffo.io distribui pacotes grátis para sempre — sem conta, sem assinatura, no máximo 2 meses atrás do upstream, correções de segurança imediatas. Hoje ele traz cliamp, Ghostty, lazydocker, Oh My Posh e Zed; Serie não está entre elas, então o repositório acima é a única forma de instalar hoje — peça e ela pode ser adicionada.
Passo 2: Instalar o Serie
# Instalar o Serie mais recente
sudo apt install serie
# Verificar a instalação
serie --version# Instalar o Serie mais recente
apt install serie
# Verificar a instalação
serie --versionPasso 3: Rodar em um repositório
# O Serie lê o repositório do diretório atual
cd /path/to/your/repo
serie
# Pressione ? a qualquer momento para ver os atalhos
# Se o grafo não aparecer, informe o protocolo de imagem explicitamente
serie -p kitty
# O arquivo de configuração opcional, para atalhos e padrões
mkdir -p ~/.config/serie
$EDITOR ~/.config/serie/config.toml🎯 Exemplos básicos de uso
Navegando pelo histórico:
# O histórico completo do repositório atual
serie
# Só os commits mais recentes, para um repositório muito grande
serie -n 5000
# Ordem topológica em vez de cronológica
serie -o topo
# Começar com o HEAD selecionado, não com o commit mais novo
serie -i headAjustando o grafo ao seu terminal:
# Forçar um protocolo de imagem quando a detecção erra
serie -p kitty
serie -p iterm
serie -p kitty-unicode
# Células de grafo mais estreitas para uma janela pequena
serie -g single
# Arestas angulares em vez de arredondadas
serie -s angular
# Ou o visual folgado e arredondado num terminal largo
serie -g double -s roundedConfiguração e uso diário:
# O arquivo de configuração, para atalhos e padrões
mkdir -p ~/.config/serie
$EDITOR ~/.config/serie/config.toml
# Ou apontar o Serie para uma configuração em outro lugar
SERIE_CONFIG_FILE=~/dotfiles/serie.toml serie
# O Serie só lê o histórico — o git continua sendo seu cliente
git -C ~/src/project log --oneline -5
# Então commitar continua sendo trabalho do git
git commit -v🔧 Integrações com outras ferramentas
o Serie precisa de duas coisas e coopera com uma terceira:
- git: um repositório Git comum e o binário
git, que o pacote instala como dependência - Seu terminal: um emulador que fale o protocolo de imagens do Kitty ou do iTerm2 — Ghostty, Kitty, WezTerm e iTerm2 servem
- Arquivo de configuração:
$XDG_CONFIG_HOME/serie/config.toml, ou o queSERIE_CONFIG_FILEapontar - Comandos de usuário: ligue
git diff, um editor ou seu script a uma tecla e rode sobre o commit selecionado - Seu cliente git: o Serie de propósito não commita nem faz push, então ele convive com lazygit, GitUI ou git puro em vez de substituí-los
🚀 Por que escolher o deb.griffo.io?
- Ubuntu oficial: não empacota o Serie — um sistema padrão não tem nada para instalar
- cargo install --locked serie: atualizado, mas exige toolchain Rust e compilação em cada máquina, fora do apt
- Tarball upstream: o binário oficial, baixado na mão a cada lançamento
- deb.griffo.io: versão mais recente com atualizações automáticas
- ✅ Jovem e em movimento: comandos de usuário, atalhos personalizáveis e as opções do grafo chegaram em lançamentos comuns — a build atual é outra ferramenta comparada à de um ano atrás
- ✅ A única fonte apt: o Serie não está nos arquivos do Debian nem do Ubuntu; este repositório empacota a build oficial upstream
- ✅ Atualizações automáticas: os pacotes são atualizados poucas horas após cada lançamento upstream
- ✅ Empacotamento honesto: o binário upstream em
/usr/bin/serie, comgitdeclarado como dependência; o upstream não publica página de manual nem conclusões, então o pacote não inventa nenhuma - ✅ Duas arquiteturas: amd64 e arm64, ambas builds musl estáticas e sem dependências
- ✅ Multi-distribuição: funciona no Ubuntu 22.04, 24.04, 25.10 e 26.04
- ✅ Manutenção simples: atualizações com os comandos apt de sempre
📦 Repositório de build do pacote
Os pacotes Ubuntu são construídos e mantidos automaticamente neste repositório do GitHub:
- 🌳 serie-debian - Builds dos últimos lançamentos
🔗 Pacotes relacionados
Também disponíveis no deb.griffo.io:
- Ghostty - Terminal que desenha o grafo via protocolo do Kitty
- lazygit - Interface git de terminal para o que o Serie deixa de fora
- Jujutsu - VCS compatível com Git e rebases de primeira classe
- Forgejo - Forge auto-hospedada por trás do histórico que você lê
git log --graph devolveu uma parede de barras e asteriscos ilegível.