Navi: dejé de googlear comandos que ya había googleado
Introducción
Seré honesto: hay comandos que ya "aprendí" tres veces y otras tres los olvidé. git worktree, el mirror -R de lftp, cómo se borra un tag remoto... Los conozco, sé que existen, pero la sintaxis exacta no se queda. Y lo peor no es olvidarla, es el ritual: abrir el navegador, buscar, entrar a Stack Overflow, copiar, pegar, cambiar los nombres por los míos. Cada vez.
Ahí es donde entra Navi, una herramienta que me parece de esas que uno debió haber conocido antes. Y en este post te cuento qué es, cómo se escribe un cheat y cómo lo estoy usando yo, con mis cheats guardados en mis dotfiles.

Qué es Navi
Navi es un cheatsheet interactivo para la línea de comandos. Tú escribes (o descargas) tus cheatsheets, y Navi te deja navegarlos con búsqueda difusa, elegir el comando y rellenar los argumentos con valores sugeridos. Por debajo usa fzf (o skim) para el buscador.
Lo que lo separa de un tldr o de una nota en Obsidian es justo eso último. Un cheatsheet normal te muestra git switch <branch> y tú completas el resto. Navi te muestra las ramas que existen en ese repo, tú eliges una, y el comando queda armado y listo para ejecutar.
Según su README, se puede usar de varias formas:
- Como comando directo (
navi). - Como widget de shell, parecido a lo que hace
Ctrl-Rcon el historial. - Como widget de Tmux.
- Como pieza dentro de scripts.
Algo que me gusta de la idea es que Navi también funciona como ayuda para aprender. Cada entrada tiene una descripción legible, así que mientras lo usas vas leyendo qué hace cada one-liner. No es una caja negra que ejecuta cosas.
Instalación
El README lista brew install navi como método principal, y hay más opciones para otros gestores de paquetes y sistemas. Revisa la sección de instalación del repositorio para el tuyo, que ahí está actualizada.
Por defecto guarda los cheats en ~/.local/share/navi/cheats/. Si quieres apuntar a otra carpeta (yo la tengo en mi repo de dotfiles), Navi acepta una ruta propia con --path.
La sintaxis de un .cheat
Un archivo .cheat es texto plano con cuatro símbolos que importan:
| Símbolo | Qué hace |
|---|---|
% | Línea de tags. Agrupa las entradas siguientes por tema. |
# | Descripción del comando que viene justo debajo. |
<variable> | Placeholder dentro del comando. |
$ | Define cómo se sugieren los valores de una variable, con un comando. |
El ejemplo mínimo del propio README es este:
% git, code
# Change branch
git checkout <branch>
$ branch: git branch | awk '{print $NF}'
Lo que pasa cuando lo ejecutas: buscas "change branch", Navi ve que el comando tiene <branch>, corre el comando de la línea $ branch: y te muestra su salida como lista para elegir. Lo que eliges se sustituye y el comando queda completo.
Esa línea $ es lo importante. Los valores no son una lista fija, son el resultado de un comando, así que las sugerencias siempre reflejan el estado real de tu máquina.
Mis cheats
Los míos viven en MyDotFiles/navi/cheats/, uno por herramienta:
local__ansible-vault.cheat
local__cargo.cheat
local__docker-devcontainer.cheat
local__git.cheat
local__herdr.cheat
local__kubectl.cheat
local__lftp.cheat
local__nmcli.cheat
local__ssh-scp.cheat
local__techflow-api.cheat
Son diez archivos y 811 líneas en total. Nada del otro mundo, y justo por eso funciona: cada uno cubre lo que uso de verdad, no el manual completo de la herramienta.
Git: lo que nunca recuerdo completo
De mi cheat de git, la parte de tags:
% git, tag
# Delete a remote tag
git push <remote> --delete <tag>
$ tag: git tag --list
$ remote: git remote
Borrar un tag remoto es de esos comandos que olvido sistemáticamente. Con Navi elijo el remoto, elijo el tag de una lista de los que existen de verdad, y no hay forma de escribir mal el nombre.
Otro ejemplo, los worktrees:
# Remove a worktree
git worktree remove <worktree>
$ worktree: git worktree list | awk '{print $1}'
herdr: descubrir panes y agentes al vuelo
Uso herdr para manejar mis paneles y agentes, y ahí los identificadores cambian todo el tiempo. Escribirlos a mano no tiene sentido:
# Run a command in a pane
herdr pane run <pane> "<command>"
$ pane: herdr pane list | grep -oE '"pane_id": *"[^"]+"' | cut -d'"' -f4
La variable pane se resuelve consultando a herdr en ese momento. Me muestra los panes que existen ahora y elijo. Lo mismo con agent y session.
lftp: la sintaxis que no se pega
lftp sube y baja carpetas con mirror, y el flag -R invierte la dirección. Nunca me acuerdo de cuál es cuál, así que lo tengo así:
# Dry run of an upload (show what would change)
lftp -u <user> <host> -e "mirror -R --delete --dry-run <local_dir> <remote_dir>; quit"
Ese --dry-run en la entrada no es casualidad: --delete borra archivos remotos que ya no existen en local, y prefiero verlo antes de ejecutarlo de verdad. Tener las dos variantes (con y sin dry-run) una junto a otra es parte del valor del cheat.
Un caso más pesado: la API de TechFlow
Aquí Navi deja de ser un recordatorio y pasa a ser una herramienta de trabajo. Mi cheat de la API de TechFlow tiene entradas que arman búsquedas completas con curl y jq. La variable <endpoint> se genera leyendo el archivo de rutas del proyecto, y <field>, <relation> y <scope> le preguntan a la propia API qué campos, relaciones y scopes tiene ese endpoint.
O sea: elijo un endpoint, y las opciones siguientes ya son las que ese endpoint soporta. No tengo que abrir la documentación para saber cómo se llama el campo por el que quiero filtrar.
El login también está resuelto ahí, con dos cuidados que vale la pena copiar en cualquier cheat que toque credenciales:
- La contraseña se pide con
read -rs, sin eco, y no queda en el historial de la shell. - El token se guarda con
umask 077, así que solo tu usuario puede leerlo.
Un .cheat es un archivo de texto, y si lo versionas termina en tu repositorio. Nunca pongas contraseñas ni tokens dentro. En mi caso las entradas leen el token de un archivo local con permisos restringidos y la contraseña se pide en el momento. Si vas a publicar tus cheats, revisa también las URLs internas.
Cómo lo integro al día a día
Navi vale la pena cuando lo tienes a un atajo de distancia. Si tienes que abrir otra herramienta para llamarlo, terminas googleando igual. El README de Navi documenta el widget de shell para eso: en lugar de escribir navi y ejecutar, lo invocas desde la misma línea de comandos y el resultado queda escrito ahí, listo para que lo revises antes de darle Enter.
Esa revisión antes de ejecutar es la parte que más me importa. Que el comando aparezca en tu prompt, y no que se ejecute solo, es lo que hace que sigas leyendo lo que corres.
Dónde no encaja
- No reemplaza aprender. Si solo copias sin leer la descripción, cambiaste el ritual de Stack Overflow por otro igual de ciego.
- Hay que mantener los cheats. Un cheat desactualizado es peor que no tener nada. Los míos viven en un repo justamente para que el cambio quede en el historial.
- Escribirlos toma tiempo. Al principio parece un gasto. Yo agrego una entrada cada vez que descubro que estoy por buscar algo por segunda vez.
Si no quieres escribir nada desde cero, el propio Navi puede traer cheats de la comunidad y se integra con formatos como tldr y cheat.sh. Yo prefiero los míos porque reflejan exactamente cómo trabajo, pero es un buen punto de partida.
Conclusión
Lo que me llevo de Navi no es "un cheatsheet más bonito". Es que dejó de ser un archivo que consulto y pasó a ser una parte de cómo trabajo. Cada vez que escribo una entrada nueva estoy dejando por escrito algo que ya sé que voy a olvidar, y esa es una forma bastante honesta de admitir que la memoria no es un buen lugar para guardar sintaxis.
No es magia, y tampoco quita el deber de entender lo que ejecutas. Pero la diferencia entre googlear por cuarta vez el mismo comando y elegirlo de una lista con los valores correctos ya puestos es, para mí, suficiente razón para tenerlo instalado.

