Repolode
Enviar
mrnugget

mrnugget/jev-shell-history

Plugin de Zsh que exibe sugestões automáticas no estilo do fish com base no histórico recente, classificadas pela API TypeSafe Jev.

Ver no GitHub
Estrelas
119
Forks
10
Issues abertas
4
Último commit
mês passado

O que é?

jev-shell-history adiciona sugestões automáticas no estilo do fish ao zsh. Enquanto você digita, o plugin considera as entradas distintas mais recentes do seu histórico e consulta a API TypeSafe Jev para saber qual delas você provavelmente está completando. A melhor correspondência aparece em cinza após o cursor, junto com sua pontuação; pressione a seta para a direita, ^E ou End para aceitá-la.

O plugin funciona em dois modos. No modo de prefixo, quando há comandos anteriores que começam literalmente com o texto digitado, somente esses comandos são considerados, e o primeiro colocado é sugerido. No modo fuzzy, quando nada corresponde ao prefixo, a API escolhe um comando provável em toda a lista recente, e uma sugestão é exibida apenas quando as pontuações ultrapassam os limites configuráveis. Cada tecla pressionada dispara uma solicitação em segundo plano, e respostas desatualizadas são descartadas quando o buffer muda.

A configuração exige zsh 5.9+, Node 22+ e uma chave da API TypeSafe. Comportamentos como o limite do histórico, o número mínimo de caracteres, os limites de pontuação, o estilo de destaque e o modelo podem ser definidos por variáveis de ambiente.

Recursos principais

  • 01Exibe sugestões inline em cinza com base no histórico recente do zsh enquanto você digita.
  • 02Aceita sugestões com a seta para a direita, ^E ou End nos keymaps emacs e vi.
  • 03Classifica as opções com a API TypeSafe Jev e exibe a pontuação.
  • 04Recorre à correspondência fuzzy quando nenhuma entrada do histórico começa com o texto digitado.
  • 05Executa solicitações em segundo plano para não bloquear o prompt.

Casos de uso

  • Recuperar comandos longos ou com várias flags que você já executou.
  • Completar comandos que não começam com os mesmos caracteres das entradas anteriores.
  • Experimentar sugestões de shell classificadas por IA em uma máquina pessoal.

Início rápido

  1. 1

    Clone o repositório em ~/.zsh/jev-shell-history

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

    Instale as dependências do npm

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

    Defina sua chave da TypeSafe API em ~/.zshrc

    export TYPESAFE_API_KEY=...
  4. 4

    Carregue o plugin com source em ~/.zshrc

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

Antes de usar

  • Requer uma chave da TypeSafe API de um plano pago e envia o histórico de comandos para a Jev API.
  • Cada tecla pressionada gera uma solicitação à API, com latência de aproximadamente 0,7–0,9 segundo por solicitação.
  • Requer zsh 5.9 ou superior e Node 22 ou superior.
  • O README não informa uma licença.

Tópicos

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

Perguntas frequentes

O que é jev-shell-history?
Plugin de Zsh que exibe sugestões automáticas no estilo do fish com base no histórico recente, classificadas pela API TypeSafe Jev. jev-shell-history adiciona sugestões automáticas no estilo do fish ao zsh. Enquanto você digita, o plugin considera as entradas distintas mais recentes do seu histórico e consulta a API TypeSafe Jev para saber qual delas você provavelmente está completando. A melhor correspondência aparece em cinza após o cursor, junto com sua pontuação; pressione a seta para a direita, ^E ou End para aceitá-la.
jev-shell-history é gratuito? Qual é a licença?
jev-shell-history não declara licença. O código é público, mas sem licença você não tem permissão explícita para reutilizá-lo; fale com o autor antes de depender dele.
jev-shell-history ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de jev-shell-history foi em 18 de set. de 2026.
Para que posso usar jev-shell-history?
Recuperar comandos longos ou com várias flags que você já executou. Completar comandos que não começam com os mesmos caracteres das entradas anteriores. Experimentar sugestões de shell classificadas por IA em uma máquina pessoal.
Como instalar jev-shell-history?
Clone o repositório em ~/.zsh/jev-shell-history: git clone <this repo> ~/.zsh/jev-shell-history Instale as dependências do npm: cd ~/.zsh/jev-shell-history && npm install Defina sua chave da TypeSafe API em ~/.zshrc: export TYPESAFE_API_KEY=... Carregue o plugin com source em ~/.zshrc: source ~/.zsh/jev-shell-history/zsh/jev-shell-history.plugin.zsh
Onde consigo jev-shell-history?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mrnugget/jev-shell-history

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados