# navi

> Interactive cheatsheet tool that helps you browse, search, and execute CLI commands with dynamic argument suggestions

Stars: 17.8k · Language: Rust · License: Apache-2.0 · Categories: Productivity

- Repository: https://github.com/denisidoro/navi
- Page: https://www.trmn.sh/tools/navi

## Install

- Homebrew: `brew install navi`

## Overview

navi is an interactive cheatsheet tool that provides a searchable interface for command-line snippets and one-liners. It uses fzf or skim to create a fuzzy-searchable menu of commands from cheatsheet files, allowing users to browse through pre-written commands and execute them directly. The tool dynamically displays suggested values for command arguments in a list format, reducing the need to memorize complex CLI syntax.

The tool supports multiple usage modes including standalone terminal execution, shell widget integration (similar to Ctrl-R history search), Tmux widget support for SSH sessions, and shell scripting automation. Users can download community-maintained cheatsheets, import repositories from Git, or write custom `.cheat` files using a simple syntax that defines commands and their parameter options. The cheatsheet format supports variable substitution where arguments are populated through command execution.

navi integrates with existing tools like tldr and cheat.sh, supports auto-updating repositories, and offers extensive customization options for colors, column sizing, and search behavior. It's particularly useful for developers, system administrators, and anyone who frequently uses complex command-line tools but doesn't want to memorize all the syntax variations.

### Installation

```bash
# via Homebrew
brew install navi
```

![navi demo](https://asciinema.org/a/406461.svg)

## Alternatives

- [presenterm](https://www.trmn.sh/tools/presenterm.md): Terminal slideshow tool that runs markdown files as presentations, with images, themes, code highlighting and execution, and PDF/HTML export. (Rust, 8.9k stars)
- [Himalaya](https://www.trmn.sh/tools/himalaya.md): Rust CLI for managing email across IMAP, SMTP, JMAP, Gmail, Microsoft Graph and Maildir backends, with multi-account TOML config and JSON output. (Rust, 7.6k stars)
- [ncspot](https://www.trmn.sh/tools/ncspot.md): Cross-platform ncurses Spotify client written in Rust on librespot, with Vim keybindings and an IPC socket for remote control. Requires Spotify Premium. (Rust, 6.8k stars)
- [pueue](https://www.trmn.sh/tools/pueue.md): Command-line task management tool for sequential and parallel execution of long-running shell commands (Rust, 6.4k stars)
- [gws](https://www.trmn.sh/tools/gws.md): Command-line tool for Google Workspace APIs (Drive, Gmail, Calendar, Sheets, Chat) with commands built at runtime from Google's Discovery Service. JSON output. (Rust, 32.1k stars)

## Guides

- [tldr Alternatives](https://www.trmn.sh/alternatives/tldr): tldr alternatives: cheat for editable cheatsheets, navi for runnable fuzzy-searched snippets, eg for paged example files.
- [tldr vs navi](https://www.trmn.sh/compare/tldr-vs-navi): tldr vs navi: tldr shows example-based help pages for commands; navi is a fuzzy-search cheatsheet launcher that runs snippets you write.

---

Canonical: https://www.trmn.sh/tools/navi