O que é o tldr?
O tldr é o cliente oficial em Rust do tldr-pages, a coleção de páginas man simplificadas mantida pela comunidade: cada página é uma descrição de uma linha do comando seguida de um punhado dos exemplos que as pessoas realmente digitam. O projeto upstream se chama tlrc; o pacote e o comando se chamam tldr. É um único binário estático sem dependências, guarda a coleção inteira num cache local para que cada consulta seja instantânea e funcione offline, e renova esse cache sozinho quando ele envelhece. As páginas vêm por plataforma (Linux, macOS, Windows, Android, os BSDs) e em dezenas de idiomas, as cores e o layout da saída ficam num arquivo TOML, e o pacote traz a página man e o autocompletar para bash, zsh e fish.
tldr do próprio Debian é outro programa, o cliente em Haskell tldr-hs, e o tealdeer do Debian também instala um /usr/bin/tldr; nenhum dos dois é o tlrc, então este repositório é o jeito de ter o cliente oficial via apt.
⚡ Principais recursos do tldr
📄 Exemplos primeiro
tldr tar imprime as oito formas como você realmente usa o tar em vez das duzentas opções que ele aceita. Comandos de várias palavras funcionam como você digita: tldr git rebase, tldr docker compose.
⚡ Um cache local, não uma requisição
A primeira execução baixa a coleção inteira; cada consulta depois disso é a leitura de um arquivo, então a página aparece antes de você tirar o dedo do Enter, num trem ou atrás de um proxy. O cache se atualiza sozinho quando passa da idade que você definir, ou com --update.
🖥️ Todas as plataformas, um comando
As páginas são organizadas por plataforma. Você recebe a do Linux por padrão e -p macos ou -p windows quando está escrevendo instruções para uma máquina que não é a que está na sua frente.
🌍 O seu idioma
O tldr-pages é traduzido para dezenas de idiomas. O tlrc segue LANG e LANGUAGE e recorre ao inglês página a página, ou -L escolhe um idioma para uma única consulta.
🔍 Encontrar a página que você não conhece
--list imprime todos os nomes de página da plataforma atual, --search procura em nomes e descrições, e --info diz que idade o cache tem e quais idiomas ele guarda.
🎨 Configurado do seu jeito
Um config.toml: cada cor e estilo da página desenhada, a idade do cache antes de uma atualização automática, os idiomas a baixar, a plataforma preferida e um diretório de páginas suas que é consultado antes do cache.
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 updatesudo apt install extrepo
sudo extrepo enable griffo
sudo 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, Uncloud e Zed; tldr não está entre elas, então o repositório acima é a única forma de instalar hoje — peça e ela pode ser adicionada.
🧩 Sobre a opção extrepo. extrepo é a ferramenta do próprio Debian para repositórios externos: ela escreve o arquivo de sources e instala a chave de assinatura para você, conferindo a chave contra metadados assinados antes de usá-la. Este repositório está registrado nela como griffo, e o espelho gratuito para sempre como griffo-free, então no Debian (bookworm, trixie, forky e sid) os comandos acima são toda a configuração.
O extrepo configura apenas o arquivo de sources e a chave: as credenciais de uma assinatura continuam indo em /etc/apt/auth.conf.d/deb.griffo.io.conf. O Ubuntu não é coberto, porque o extrepo publica metadados só para as suítes do Debian: lá, use os comandos com sudo ou como root.
Passo 2: Instalar o tldr
# Instalar o tldr mais recente
# Se o tealdeer estiver instalado, o apt o remove primeiro: os dois
# pacotes colocam /usr/bin/tldr no seu PATH, então este o substitui
sudo apt install tldr
# Verificar a instalação
tldr --version# Instalar o tldr mais recente
# Se o tealdeer estiver instalado, o apt o remove primeiro: os dois
# pacotes colocam /usr/bin/tldr no seu PATH, então este o substitui
apt install tldr
# Verificar a instalação
tldr --versionPasso 3: Primeira execução
# A primeira consulta baixa o cache de páginas, então precisa
# de internet uma vez; tudo depois disso é local
tldr tar
# Renovar o cache à mão quando quiser
tldr --update
# Onde o cache fica, que idade tem e quais idiomas guarda
tldr --info
# Todas as opções
tldr --help🎯 Exemplos básicos de uso
Consultando:
# A página de um comando
tldr tar
# Subcomandos, escritos como você digitaria
tldr git rebase
# Uma página de outra plataforma
tldr -p macos brew
tldr -p windows choco
# Uma página em outro idioma, para uma única consulta
tldr -L pt_BR tar
# Todos os nomes de página desta plataforma, e uma busca por
# nomes e descrições quando você não sabe o comando
tldr --list
tldr --search "compress"Moldando a saída:
# Markdown puro, para encadear em outra coisa
tldr -R tar
# Sem as linhas em branco, num terminal pequeno
tldr --compact tar
# Sem cores, para logs e scripts
tldr --color never tar
# Nunca tocar na rede, mesmo com o cache vencido
tldr --offline tar
# Desenhar uma página que você está escrevendo antes de mandá-la upstream
tldr -r my-command.mdDeixando do seu jeito:
# De onde a configuração é lida, e um padrão para começar
tldr --config-path
mkdir -p "$(dirname "$(tldr --config-path)")"
tldr --gen-config > "$(tldr --config-path)"
# Depois, no config.toml: idade do cache antes de uma atualização
# automática, os idiomas a manter, a plataforma preferida
# e as cores de cada parte de uma página
# Limpar o cache se um download deu errado
tldr --clean-cache🔧 Integrações
O tldr é uma consulta, então ele se encaixa ao lado das ferramentas que você já usa:
- Sua shell: o pacote instala o autocompletar para bash, zsh e fish, então
tldr gi<tab>completa nomes de página a partir do cache, eman tldrestá lá para o próprio cliente - fzf:
tldr --list | fzf | xargs tldré um seletor difuso de páginas em uma linha, e a saída de--rawalimenta o painel de pré-visualização - Corrigir uma página:
tldr --edit tarimprime um link que abre essa página no editor web do GitHub, então corrigir uma página tldr está a um pull request de distância - man: o tldr não substitui o manual, é a primeira coisa a ler; a página completa está a um
mande distância assim que você sabe qual opção quer - Scripts e docs:
--color nevere--rawdeixam a saída segura para colar num README, num ticket ou num log
🚀 Por que escolher o deb.griffo.io?
- Debian oficial:
apt install tldrentrega o tldr-hs, o cliente em Haskell, e otealdeeré outro cliente em Rust com o mesmo nome de comando; nenhum dos dois é o tlrc oficial - Compilar do código-fonte: atual, mas exige uma toolchain Rust em cada máquina e deixa um binário que o apt desconhece
- O tarball do lançamento upstream: o mesmo binário estático, mas descompactado à mão no seu PATH, sem autocompletar, sem página man e sem atualizações
- deb.griffo.io: versão mais recente com atualizações automáticas
- ✅ O cliente oficial: o tlrc, o cliente que o próprio projeto tldr-pages mantém, não uma das muitas reimplementações
- ✅ O comando é tldr: o pacote se chama tldr porque esse é o comando, e ele conflita com o
tealdeere o substitui, então nunca há disputa pelo/usr/bin/tldr - ✅ Atualizações automáticas: os pacotes são atualizados poucas horas após cada lançamento upstream, e o cache de páginas se atualiza sozinho por cima
- ✅ Pacote completo: o binário, a página man e o autocompletar para bash, zsh e fish
- ✅ Zero dependências: um binário musl com ligação estática, nada mais é puxado
- ✅ Duas arquiteturas: amd64 e arm64, o mesmo binário estático em todas as suítes
- ✅ Multi-distribuição: funciona no Debian 13 (trixie) ou mais novo: Trixie, Forky e Sid
- ✅ Manutenção simples: atualizações com os comandos apt de sempre
📦 Repositório de build do pacote
Os pacotes Debian são construídos e mantidos automaticamente neste repositório do GitHub:
- 📖 tldr-debian - Builds dos últimos lançamentos
🔗 Pacotes relacionados
Também disponíveis no deb.griffo.io:
- fzf Fuzzy Finder - Transforma
tldr --listnum seletor de páginas interativo - ripgrep - A ferramenta de busca cuja página do tldr você vai ler primeiro
- eza - Um ls moderno, mais um comando com bem menos opções para decorar
- zoxide - Um cd mais esperto para a shell em que você lê as páginas