navi CLI
navi, CLI поиска по шпаргалкам, подставляет команду в строку оболочки через виджет, чтобы пользователь изменил ее перед запуском.
- 17 837 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Рецепты и динамические подсказки запускают команды с доступами текущего пользователя.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/naviОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Рецепты и динамические подсказки запускают команды с доступами текущего пользователя.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
navi, терминальный инструмент, ищет команду по описанию в файлах шпаргалок. Пользователь выбирает рецепт и подставляет аргументы из предложенного списка. Подсказки могут строиться динамически, например из веток текущего Git-репозитория. Шпаргалки можно писать самому или получать из чужих репозиториев. Виджет оболочки возвращает выбранную команду в строку ввода, где ее можно изменить перед выполнением. Поиск использует fzf или skim, а текст рецептов хранится в читаемых файлах с расширением `.cheat`.
Для кого. Дежурным инженерам, которые редко вызывают сложные CLI и хотят хранить проверенные команды с подставляемыми параметрами.
Подходит, если
- Вы редко вызываете сложную команду и ищете ее по описанию задачи.
- Команда проекта собирает общую шпаргалку из проверенных вариантов запуска.
- Параметр зависит от файлов или веток проекта, и вы выбираете значение из списка.
- Найденный рецепт подходит частично; через виджет вы вставляете его в оболочку для правки.
Не подходит, если
- Сценарий должен выполняться без человека и интерактивных вопросов.
- Вы собираетесь запускать чужие рецепты с доступом к рабочим данным, не прочитав их команды.
- Нужна активно развиваемая платформа с новыми возможностями по плану команды.
Пример запроса к агенту
Подготовь шпаргалку navi для трех команд нашего проекта с выбором ветки. Покажи рецепты и подсказки до запуска.Ограничения
Проект находится в режиме поддержки: исправления ошибок продолжаются, новые функции не планируются. Для поиска используется fzf или skim, поэтому доступность выбранного инструмента нужно проверить в окружении. Динамические подсказки и сами рецепты могут исполнять команды, а содержимое сторонних шпаргалок требует просмотра. Виджет оболочки настраивается отдельно; запуск navi как обычной команды не дает того же этапа редактирования в строке ввода.
Как отключить. Удалите виджет из настройки оболочки и пакет navi через менеджер установки. Сохраните собственные шпаргалки отдельно.
Частые вопросы
Где лежат шпаргалки?
По умолчанию в `~/.local/share/navi/cheats/`. Проверьте этот каталог перед импортом новых рецептов.
Можно ли писать свои команды?
Да. Создайте `.cheat` с описанием, командой и при необходимости источником значений параметра. Проверьте на тестовых данных.
Чем полезен виджет оболочки?
Виджет вставляет команду в строку ввода и историю, поэтому до Enter можно изменить параметры. Подключите его по [инструкции для своей оболочки](https://github.com/denisidoro/navi/blob/master/docs/widgets/README.md#installing-the-shell-widget).
Поддерживаются ли внешние репозитории?
Да. Для импорта служит подкоманда `navi repo add`. Адрес репозитория и варианты подключения описаны в [руководстве по импорту](https://github.com/denisidoro/navi/blob/master/docs/cheatsheet/repositories/README.md#importing-cheatsheet-repositories).
Как увидеть параметры запуска?
Выполните `navi --help`. Выбирайте режим по справке установленной версии.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыИнтерактивный поиск в терминале помогает выбирать файлы, команды из истории и строки из длинного списка по частям названия.
CLI повторяет выбранную команду, подсвечивает изменения вывода и хранит историю для сравнения результатов пользователем и агентом.
CLI строит локальный индекс заметок с «катализаторами», вопросами по вашим записям, чтобы агент находил нужное лучше grep
Именованные буферы обмена сохраняют текст и файлы из терминала, чтобы переносить результаты между командами и сеансами.
Скилл и консольная утилита читают, ищут и правят страницы Cosense (прежний Scrapbox) прямо из Claude Code и Codex.
organize — CLI для разбора загрузок и фотоархивов: выбирает файлы по тексту документов и данным снимков EXIF.
Коротко о README
В конфигурации задают пути к шпаргалкам, цвета и ширину столбцов. Кроме виджета оболочки, есть вариант для Tmux и вызов через псевдонимы команд.