denisidoro /navi
An interactive cheatsheet tool for the command-line
★ 17,861⑂ 584👁 114⑃ 629● 436▤ 69
+5
Daily
17,861
stars
584
forks
114
watchers
629
prs
436
issues
69
releases
README
navi !GitHub release
An interactive cheatsheet tool for the command-line.
[!NOTE]
Maintenance mode. navi still gets bug fixes, but no new features are planned. For a more modern alternative, check out ezlo.
navi allows you to browse through cheatsheets (that you may write yourself or download from maintainers) and execute commands. Suggested values for arguments are dynamically displayed in a list.
Pros
- it will spare you from knowing CLIs by heart
- it will spare you from copy-pasting output from intermediate commands
- it will make you type less
- it will teach you new one-liners
It uses fzf or skim under the hood and it can be either used as a command or as a shell widget (_à la_ Ctrl-R).
Table of contents
- Installation
- Usage
- Cheatsheet repositories
- Cheatsheet syntax
- Customization
- More info
Installation
The recommended way to install navi is by running:
sh
brew install navi
[!NOTE]
For more details on how to install Navi, see docs/installation
navi can be installed with the following package managers:
Usage
There are multiple ways to use navi:
- by typing navi in the terminal
- pros: you have access to all possible subcommands and flags
- as a shell widget for the terminal
- pros: the shell history is correctly populated (i.e. with the actual command you ran instead of navi) and you can edit the command as you wish before executing it
- as a Tmux widget
- pros: you can use your cheatsheets in any command-line app even in SSH sessions
- as aliases
- as a shell scripting tool
In particular, check these instructions if you want to replicate what's shown in the demo above.
Cheatsheet repositories
Running navi for the first time will help you download and manage cheatsheets. By default, they are stored at ~/.local/share/navi/cheats/.
You can also:
- browse through featured cheatsheets
- import cheatsheets from git repositories
- write your own cheatsheets (and share them, if you want)
- use cheatsheets from other tools, such as tldr and cheat.sh
- auto-update repositories
- auto-export cheatsheets from your TiddlyWiki notes using a TiddlyWiki plugin
Cheatsheet syntax
Cheatsheets are described in .cheat files that look like this:
sh
% git, code
Change branch
git checkout
$ branch: git branch | awk '{print $NF}'
The full syntax and examples can be found here.
Customization
You can:
- setup your own config file
- set custom paths for your config file and cheat sheets
- change colors
- resize columns
- change how search is performed
More info
Please run the following command to read more about all possible options:
sh
navi --help
In addition, please check the /docs folder or the website.Top issues
#733Easy sync of downloaded cheatsheets15 comments · 2022-05-19#979Feat: Have the ability to add multiple values for the same optional variable14 comments · 2025-05-03#459navi cannot search cheats with truncated tags or comments14 comments · 2021-02-25#841How to escape dollar or colon?10 comments · 2023-05-22#937Refactor documentation + improvements9 comments · 2025-02-04#897/usr/bin/bash: line 1: C:ProgramDatachocolateylibnavitoolsnavi.exe: command not found9 comments · 2024-05-14#794command not found error9 comments · 2022-09-19#777Installing navi correctly on MacOS for .zsh9 comments · 2022-08-12
Latest release
2.24.0 v2.24.0 2025-01-29🐛 Fixes - Improvements for Windows - Improvements for the fish plugin 💻 Code quality - Documentation improvements Note: builds for Apple devices are broken right now. They'll be available in the next release.