Repolode
Enviar
mrnugget

mrnugget/jev-shell-history

Plugin de Zsh que muestra sugerencias automáticas al estilo de fish a partir del historial reciente, clasificadas por la API de TypeSafe Jev.

Ver en GitHub
Estrellas
119
Forks
10
Issues abiertos
4
Último commit
el mes pasado

¿Qué es?

jev-shell-history añade sugerencias automáticas al estilo de fish a zsh. Mientras escribes, toma las entradas distintas más recientes del historial y consulta a la API de TypeSafe Jev para que determine cuál es más probable que estés completando. La coincidencia principal aparece en gris después del cursor, junto con su puntuación, y puedes aceptarla con la flecha derecha, ^E o End.

El plugin funciona en dos modos. En el modo de prefijo, si algunos comandos anteriores empiezan literalmente con el texto escrito, solo esos son candidatos y se sugiere el mejor. En el modo difuso, si no hay coincidencias de prefijo, se pide a la API que elija un comando probable de toda la lista reciente, y solo se muestra una sugerencia si las puntuaciones superan los umbrales configurables. Cada pulsación de tecla genera una solicitud en segundo plano y se descartan las respuestas obsoletas si cambia el búfer.

La configuración requiere zsh 5.9+, Node 22+ y una clave de API de TypeSafe. El límite del historial, el mínimo de caracteres, los umbrales, el estilo de resaltado y el modelo, entre otros aspectos, se pueden configurar mediante variables de entorno.

Funciones clave

  • 01Muestra sugerencias en línea de color gris a partir del historial reciente de zsh mientras escribes.
  • 02Acepta sugerencias con la flecha derecha, ^E o End en los mapas de teclas de emacs y vi.
  • 03Clasifica los candidatos con la API de TypeSafe Jev y muestra la puntuación.
  • 04Recurre a la coincidencia difusa cuando ninguna entrada del historial empieza con el texto escrito.
  • 05Ejecuta las solicitudes en segundo plano para que el prompt no se bloquee.

Casos de uso

  • Recuperar comandos de shell largos o con varias opciones que ya hayas ejecutado.
  • Completar comandos que no empiezan con los mismos caracteres que las entradas anteriores.
  • Probar sugerencias de shell clasificadas por IA en un equipo personal.

Inicio rápido

  1. 1

    Clona el repositorio en ~/.zsh/jev-shell-history

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

    Instala las dependencias de npm

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

    Configura tu clave de TypeSafe API en ~/.zshrc

    export TYPESAFE_API_KEY=...
  4. 4

    Carga el plugin con source en ~/.zshrc

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

Antes de usarlo

  • Requiere una clave de TypeSafe API de pago y envía el historial de comandos a Jev API.
  • Cada pulsación de tecla genera una solicitud a la API, con una latencia de aproximadamente 0,7–0,9 segundos por solicitud.
  • Requiere zsh 5.9 o posterior y Node 22 o posterior.
  • El README no indica ninguna licencia.

Temas

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

Preguntas frecuentes

¿Qué es jev-shell-history?
Plugin de Zsh que muestra sugerencias automáticas al estilo de fish a partir del historial reciente, clasificadas por la API de TypeSafe Jev. jev-shell-history añade sugerencias automáticas al estilo de fish a zsh. Mientras escribes, toma las entradas distintas más recientes del historial y consulta a la API de TypeSafe Jev para que determine cuál es más probable que estés completando. La coincidencia principal aparece en gris después del cursor, junto con su puntuación, y puedes aceptarla con la flecha derecha, ^E o End.
¿jev-shell-history es gratuito? ¿Qué licencia tiene?
jev-shell-history no declara ninguna licencia. Su código es público, pero sin licencia no tienes permiso explícito para reutilizarlo; consulta al autor antes de depender de él.
¿jev-shell-history sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de jev-shell-history fue el 18 sept 2026.
¿Para qué puedo usar jev-shell-history?
Recuperar comandos de shell largos o con varias opciones que ya hayas ejecutado. Completar comandos que no empiezan con los mismos caracteres que las entradas anteriores. Probar sugerencias de shell clasificadas por IA en un equipo personal.
¿Cómo se instala jev-shell-history?
Clona el repositorio en ~/.zsh/jev-shell-history: git clone <this repo> ~/.zsh/jev-shell-history Instala las dependencias de npm: cd ~/.zsh/jev-shell-history && npm install Configura tu clave de TypeSafe API en ~/.zshrc: export TYPESAFE_API_KEY=... Carga el plugin con source en ~/.zshrc: source ~/.zsh/jev-shell-history/zsh/jev-shell-history.plugin.zsh
¿Dónde consigo jev-shell-history?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/mrnugget/jev-shell-history

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados