¿Qué es tldr?
tldr es el cliente oficial en Rust de tldr-pages, la colección de páginas man simplificadas que mantiene la comunidad: cada página es una descripción de una línea del comando seguida de un puñado de los ejemplos que la gente escribe de verdad. El proyecto upstream se llama tlrc; el paquete y el comando se llaman tldr. Es un único binario estático sin dependencias, guarda toda la colección en una caché local para que cada consulta sea instantánea y funcione sin conexión, y refresca esa caché por su cuenta cuando envejece. Las páginas vienen por plataforma (Linux, macOS, Windows, Android, los BSD) y en decenas de idiomas, los colores y la disposición de la salida son un archivo TOML, y el paquete incluye la página man y el autocompletado para bash, zsh y fish.
tldr de Debian es otro programa, el cliente en Haskell tldr-hs, y el tealdeer de Debian también instala un /usr/bin/tldr; ninguno de los dos es tlrc, así que este repositorio es la forma de tener el cliente oficial por apt.
⚡ Funciones clave de tldr
📄 Los ejemplos primero
tldr tar imprime las ocho formas en que usas tar de verdad en lugar de las doscientas opciones que acepta. Los comandos de varias palabras funcionan tal como los escribes: tldr git rebase, tldr docker compose.
⚡ Una caché local, no una petición
La primera ejecución descarga toda la colección; cada consulta posterior es leer un archivo, así que la página aparece antes de levantar el dedo de Intro, en un tren o detrás de un proxy. La caché se actualiza sola cuando supera la edad que fijes, o con --update.
🖥️ Todas las plataformas, un comando
Las páginas están organizadas por plataforma. Por defecto obtienes la de Linux, y -p macos o -p windows cuando escribes instrucciones para una máquina que no es la que tienes delante.
🌍 Tu idioma
tldr-pages está traducido a decenas de idiomas. tlrc sigue LANG y LANGUAGE y recurre al inglés página a página, o -L elige uno para una sola consulta.
🔍 Encontrar la página que no conoces
--list imprime todos los nombres de página de la plataforma actual, --search busca en nombres y descripciones, y --info te dice qué edad tiene la caché y qué idiomas contiene.
🎨 Configurado a tu gusto
Un config.toml: cada color y estilo de la página dibujada, la edad de la caché antes de una actualización automática, los idiomas que descargar, la plataforma preferida y un directorio de páginas propias que se consulta antes que la caché.
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, Uncloud y Zed; tldr 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 tldr
# Instalar la última versión de tldr
# Si tealdeer está instalado, apt lo quita primero: los dos paquetes
# ponen /usr/bin/tldr en tu PATH, así que este lo reemplaza
sudo apt install tldr
# Verificar la instalación
tldr --version# Instalar la última versión de tldr
# Si tealdeer está instalado, apt lo quita primero: los dos paquetes
# ponen /usr/bin/tldr en tu PATH, así que este lo reemplaza
apt install tldr
# Verificar la instalación
tldr --versionPaso 3: Primer arranque
# La primera consulta descarga la caché de páginas, así que
# necesita internet una vez; todo lo demás es local
tldr tar
# Refrescar la caché a mano cuando quieras
tldr --update
# Dónde vive la caché, qué edad tiene y qué idiomas contiene
tldr --info
# Todas las opciones
tldr --help🎯 Ejemplos básicos de uso
Consultar:
# La página de un comando
tldr tar
# Subcomandos, escritos como los teclearías
tldr git rebase
# Una página de otra plataforma
tldr -p macos brew
tldr -p windows choco
# Una página en otro idioma para una sola consulta
tldr -L es tar
# Todos los nombres de página de esta plataforma, y una búsqueda
# por nombres y descripciones cuando no sabes el comando
tldr --list
tldr --search "compress"Dar forma a la salida:
# Markdown en crudo, para encadenarlo a otra cosa
tldr -R tar
# Quitar las líneas en blanco en una terminal pequeña
tldr --compact tar
# Sin colores, para logs y scripts
tldr --color never tar
# No tocar nunca la red, aunque la caché esté caducada
tldr --offline tar
# Dibujar una página que estás escribiendo antes de enviarla upstream
tldr -r my-command.mdHacerlo tuyo:
# De dónde se lee la configuración, y un valor por defecto para empezar
tldr --config-path
mkdir -p "$(dirname "$(tldr --config-path)")"
tldr --gen-config > "$(tldr --config-path)"
# Luego, en config.toml: edad de la caché antes de una actualización
# automática, los idiomas que conservar, la plataforma preferida
# y los colores de cada parte de una página
# Vaciar la caché si una descarga salió mal
tldr --clean-cache🔧 Integraciones
tldr es una consulta, así que encaja junto a las herramientas que ya usas:
- Tu shell: el paquete instala el autocompletado para bash, zsh y fish, así que
tldr gi<tab>completa nombres de página desde la caché, yman tldrestá ahí para el propio cliente - fzf:
tldr --list | fzf | xargs tldres un selector difuso de páginas en una línea, y la salida de--rawalimenta el panel de vista previa - Corregir una página:
tldr --edit tarimprime un enlace que abre esa página en el editor web de GitHub, así que corregir una página tldr está a un pull request de distancia - man: tldr no sustituye al manual, es lo primero que se lee; la página completa está a un
mande distancia en cuanto sabes qué opción quieres - Scripts y documentación:
--color nevery--rawhacen que la salida se pueda pegar sin miedo en un README, un ticket o un log
🚀 ¿Por qué elegir deb.griffo.io?
- Debian oficial:
apt install tldrte da tldr-hs, el cliente en Haskell, ytealdeeres otro cliente en Rust con el mismo nombre de comando; ninguno de los dos es el tlrc oficial - Compilar desde el código: actualizado, pero exige una cadena de Rust en cada máquina y deja un binario del que apt no sabe nada
- El tarball de la release upstream: el mismo binario estático, pero desempaquetado a mano en tu PATH, sin autocompletado, sin página man y sin actualizaciones
- deb.griffo.io: última versión con actualizaciones automáticas
- ✅ El cliente oficial: tlrc, el cliente que mantiene el propio proyecto tldr-pages, no una de las muchas reimplementaciones
- ✅ El comando es tldr: el paquete se llama tldr porque ese es el comando, y entra en conflicto con
tealdeery lo reemplaza, así que nunca hay pelea por/usr/bin/tldr - ✅ Actualizaciones automáticas: los paquetes se actualizan pocas horas después de cada versión upstream, y la caché de páginas se actualiza sola por encima
- ✅ Paquete completo: el binario, la página man y el autocompletado para bash, zsh y fish
- ✅ Cero dependencias: un binario musl enlazado estáticamente, no arrastra nada más
- ✅ Dos arquitecturas: amd64 y arm64, el mismo binario estático en todas las suites
- ✅ Multidistribución: funciona en Debian 13 (trixie) o posterior: 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:
- 📖 tldr-debian - Compilaciones de las últimas versiones
🔗 Paquetes relacionados
También disponibles en deb.griffo.io:
- fzf Fuzzy Finder - Convierte
tldr --listen un selector de páginas interactivo - ripgrep - La herramienta de búsqueda cuya página de tldr leerás primero
- eza - Un ls moderno, otro comando con muchas menos opciones que recordar
- zoxide - Un cd más listo para la shell en la que lees las páginas