Repolode
Submit
mrnugget

mrnugget/jev-shell-history

Zsh plugin that shows fish-style autosuggestions from your recent history, ranked by the TypeSafe Jev API.

View on GitHub
Stars
119
Forks
10
Open issues
4
Last commit
last month

What is it?

jev-shell-history adds fish-style autosuggestions to zsh. As you type, it considers your most recent distinct history entries and asks the TypeSafe Jev API which one you are most likely completing. The top match appears in grey after the cursor along with its score, and pressing the right arrow, ^E, or End accepts it.

The plugin works in two modes. In prefix mode, when some past commands literally start with the typed text, only those are candidates and the top one is suggested. In fuzzy mode, when nothing matches the prefix, the API is asked to pick a likely command from the whole recent list, and a suggestion is shown only when the scores clear configurable thresholds. Each keystroke triggers one background request, and stale responses are discarded when the buffer changes.

Setup requires zsh 5.9+, Node 22+, and a TypeSafe API key. Behavior such as history limit, minimum characters, thresholds, highlight style, and the model can be set through environment variables.

Key features

  • 01Shows grey inline suggestions from recent zsh history as you type.
  • 02Accepts suggestions with the right arrow, ^E, or End in emacs and vi keymaps.
  • 03Ranks candidates with the TypeSafe Jev API and displays the score.
  • 04Falls back to fuzzy matching when no history entry starts with the input.
  • 05Runs requests in the background so the prompt does not block.

Use cases

  • Recalling long or multi-flag shell commands you have run before.
  • Completing commands that do not start with the same characters as past entries.
  • Experimenting with AI-ranked shell suggestions on a personal machine.

Quick start

  1. 1

    Clone the repository into ~/.zsh/jev-shell-history

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

    Install npm dependencies

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

    Set your TypeSafe API key in ~/.zshrc

    export TYPESAFE_API_KEY=...
  4. 4

    Source the plugin in ~/.zshrc

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

Things to know

  • Requires a paid-tier TypeSafe API key and sends your command history to the Jev API.
  • Each keystroke makes an API request, with roughly 0.7–0.9 seconds of latency per request.
  • Requires zsh 5.9+ and Node 22+.
  • The README does not state a license.

Topics

#zsh#shell#autosuggestions#command-line#typescript#llm

FAQ

What is jev-shell-history?
Zsh plugin that shows fish-style autosuggestions from your recent history, ranked by the TypeSafe Jev API. jev-shell-history adds fish-style autosuggestions to zsh. As you type, it considers your most recent distinct history entries and asks the TypeSafe Jev API which one you are most likely completing. The top match appears in grey after the cursor along with its score, and pressing the right arrow, ^E, or End accepts it.
Is jev-shell-history free to use? What license does it have?
jev-shell-history has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is jev-shell-history still maintained?
Updated within 6 months. The last commit to jev-shell-history was on Sep 18, 2026.
What can I use jev-shell-history for?
Recalling long or multi-flag shell commands you have run before. Completing commands that do not start with the same characters as past entries. Experimenting with AI-ranked shell suggestions on a personal machine.
How do I install jev-shell-history?
Clone the repository into ~/.zsh/jev-shell-history: git clone <this repo> ~/.zsh/jev-shell-history Install npm dependencies: cd ~/.zsh/jev-shell-history && npm install Set your TypeSafe API key in ~/.zshrc: export TYPESAFE_API_KEY=... Source the plugin in ~/.zshrc: source ~/.zsh/jev-shell-history/zsh/jev-shell-history.plugin.zsh
Where can I get jev-shell-history?
The source code and installation instructions are on GitHub: https://github.com/mrnugget/jev-shell-history

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects