navi README

The project's README from github.com/denisidoro/navi. As one markdown file: README.md.

navi icon Actions Status GitHub release

An interactive cheatsheet tool for the command-line.

Demo

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 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

The recommended way to install navi is by running:

brew install navi

[!NOTE] For more details on how to install Navi, see docs/installation

navi can be installed with the following package managers:

Packaging status

Usage

There are multiple ways to use navi:

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:

Cheatsheet syntax

Cheatsheets are described in .cheat files that look like this:

% git, code

# Change branch
git checkout <branch>

$ branch: git branch | awk '{print $NF}'

The full syntax and examples can be found here.

Customization

You can:

More info

Please run the following command to read more about all possible options:

navi --help

In addition, please check the /docs folder or the website.

navi (denisidoro/navi)

Searching Database…

17.8K ·GitHub
What is this?navi is an interactive cheatsheet tool for the command-line: you browse cheatsheets — written by you or downloaded from maintainers — and execute commands straight from them.
Is it a library I import into my code, or a standalone app?A standalone interactive terminal app written in Rust, not a library. You can run it as a plain command, as a shell widget à la Ctrl-R, as a Tmux widget, as aliases, or as a shell scripting tool.
How do I get it onto my machine?Install it through a package manager; the README points to docs/installation for the exact commands.
Does it need anything else installed to work?One dependency worth knowing: navi is built on fzf or skim — the fuzzy finders that power its interactive selection of commands.
Will it run on Linux, macOS and Windows alike?It's cross-platform: the repo packages it for Linux, macOS and Windows, and the Tmux widget mode works even inside SSH sessions on remote machines.
What happens the first time I run it?It walks you through downloading and managing cheatsheets. By default they are stored at ~/.local/share/navi/cheats/.
Do I have to write all the cheatsheets myself?No — you can browse featured cheatsheets, import them from git repositories, reuse cheatsheets from tldr and cheat.sh, write and share your own, auto-update repositories, and even auto-export them from your TiddlyWiki notes via a plugin.
What does a cheatsheet file look like?Cheatsheets are plain .cheat files with a simple syntax; the full syntax and examples are documented in the repo's docs.
Why use this instead of just googling commands?Per its README, navi spares you from knowing CLIs by heart, saves you from copy-pasting output from intermediate commands, makes you type less, and teaches you new one-liners along the way.
What are similar projects?gum, gitui, cheat, bashka, z, fish-shell, zx, Gogh
Creator
denisidoro
Size
1.5 MB
Stars
17.8K
Age
7y
Commits · 90 Days