Repolode
mrnugget

mrnugget/jev-shell-history

Плагин для zsh, который предлагает команды из недавней истории в стиле fish и ранжирует их с помощью API TypeSafe Jev.

Звёзды
119
Форки
10
Открытые issues
4
Последний коммит
в прошлом месяце

Что это?

jev-shell-history добавляет в zsh автоподсказки в стиле fish. Пока вы вводите команду, плагин просматривает последние уникальные записи истории и обращается к API TypeSafe Jev, чтобы определить, какую из них вы, скорее всего, дописываете. Лучшее совпадение отображается серым цветом после курсора вместе с оценкой; принять его можно клавишей со стрелкой вправо, ^E или End.

Плагин работает в двух режимах. В режиме префикса, если некоторые прошлые команды буквально начинаются с введённого текста, кандидатами становятся только они, и предлагается лучшая. В режиме нечёткого поиска, если совпадений по префиксу нет, API выбирает вероятную команду из всего недавнего списка, а подсказка показывается, только если оценки превышают настраиваемые пороги. Каждое нажатие клавиши запускает один фоновый запрос; устаревшие ответы отбрасываются, если содержимое буфера изменилось.

Для настройки нужны zsh 5.9+, Node 22+ и API-ключ TypeSafe. Такие параметры, как лимит истории, минимальное число символов, пороговые значения, стиль подсветки и модель, можно задать через переменные окружения.

Ключевые возможности

  • 01Показывает серые встроенные подсказки из недавней истории zsh по мере ввода команды.
  • 02Принимает подсказки клавишей со стрелкой вправо, ^E или End в раскладках emacs и vi.
  • 03Ранжирует варианты с помощью API TypeSafe Jev и показывает оценку.
  • 04Переходит к нечёткому поиску, если ни одна запись истории не начинается с введённого текста.
  • 05Выполняет запросы в фоне, чтобы не блокировать приглашение командной строки.

Сценарии использования

  • Вспоминать длинные команды оболочки и команды со множеством флагов, которые вы уже вводили.
  • Дополнять команды, которые не начинаются с тех же символов, что и записи истории.
  • Экспериментировать с подсказками командной строки, ранжированными с помощью ИИ, на личном компьютере.

Быстрый старт

  1. 1

    Клонируйте репозиторий в ~/.zsh/jev-shell-history

    git clone <this repo> ~/.zsh/jev-shell-history
  2. 2

    Установите зависимости npm

    cd ~/.zsh/jev-shell-history && npm install
  3. 3

    Укажите ключ TypeSafe API в ~/.zshrc

    export TYPESAFE_API_KEY=...
  4. 4

    Подключите плагин с помощью source в ~/.zshrc

    source ~/.zsh/jev-shell-history/zsh/jev-shell-history.plugin.zsh

Что важно знать

  • Требуется ключ TypeSafe API для платного тарифа; история команд отправляется в Jev API.
  • Каждое нажатие клавиши вызывает запрос к API с задержкой примерно 0,7–0,9 секунды на запрос.
  • Требуются zsh 5.9 или новее и Node 22 или новее.
  • В README не указана лицензия.

Темы

Частые вопросы

Что такое jev-shell-history?
Плагин для zsh, который предлагает команды из недавней истории в стиле fish и ранжирует их с помощью API TypeSafe Jev. jev-shell-history добавляет в zsh автоподсказки в стиле fish. Пока вы вводите команду, плагин просматривает последние уникальные записи истории и обращается к API TypeSafe Jev, чтобы определить, какую из них вы, скорее всего, дописываете. Лучшее совпадение отображается серым цветом после курсора вместе с оценкой; принять его можно клавишей со стрелкой вправо, ^E или End.
jev-shell-history можно использовать бесплатно? Какая у него лицензия?
У jev-shell-history не указана лицензия. Код открыт, но без лицензии нет явного разрешения на его использование — уточните у автора, прежде чем на него полагаться.
jev-shell-history всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в jev-shell-history — 18 сент. 2026 г..
Для чего можно использовать jev-shell-history?
Вспоминать длинные команды оболочки и команды со множеством флагов, которые вы уже вводили. Дополнять команды, которые не начинаются с тех же символов, что и записи истории. Экспериментировать с подсказками командной строки, ранжированными с помощью ИИ, на личном компьютере.
Как установить jev-shell-history?
Клонируйте репозиторий в ~/.zsh/jev-shell-history: git clone <this repo> ~/.zsh/jev-shell-history Установите зависимости npm: cd ~/.zsh/jev-shell-history && npm install Укажите ключ TypeSafe API в ~/.zshrc: export TYPESAFE_API_KEY=... Подключите плагин с помощью source в ~/.zshrc: source ~/.zsh/jev-shell-history/zsh/jev-shell-history.plugin.zsh
Где скачать jev-shell-history?
Исходный код и инструкции по установке — на GitHub: https://github.com/mrnugget/jev-shell-history

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Apache Maka (Incubating) — рабочее пространство для агентов с интерфейсами Desktop, TUI и CLI, которое записывает каждое сообщение модели, вызов инструмента и решение о разрешении в журнал событий только для добавления.

5,9 тыс.559TypeScriptApache-2.0Обновлён вчера