Repolode
Realiserad

Realiserad/fish-ai

Un plugin para Fish shell que usa LLM para convertir comentarios en comandos, explicar comandos, corregir errores tipográficos y autocompletar la línea de comandos.

Estrellas
566
Forks
52
Issues abiertos
1
Último commit
anteayer

¿Qué es?

fish-ai es un plugin para Fish shell que conecta la línea de comandos con un modelo de lenguaje. Escribe un comentario que describa una tarea y pulsa un atajo para obtener un comando de shell, o escribe un comando y obtén un comentario que explique qué hace. Esto resulta útil con herramientas que tienen muchas opciones, como git, kubectl y curl.

El plugin también puede sugerir una corrección cuando falla un comando y ofrece autocompletado de comandos o comentarios. Los resultados se muestran en un buscador difuso fzf integrado, donde puedes ajustar las sugerencias con instrucciones adicionales. Todo se activa mediante atajos de teclado configurables y se instala con fisher.

El backend del modelo se configura en un archivo INI. Admite proveedores como Anthropic, OpenAI, Google, AWS Bedrock, Groq, Cohere y OpenRouter, además de cualquier servidor autohospedado compatible con OpenAI, como Ollama. El plugin envía al modelo el nombre del sistema operativo, el búfer de comandos y el contexto relacionado, y oculta algunos valores sensibles, como las API keys pasadas como argumentos.

Funciones clave

  • 01Convierte comentarios en comandos de shell y explica comandos existentes mediante comentarios.
  • 02Sugiere correcciones para comandos que fallan.
  • 03Autocompleta comandos con un selector basado en fzf que permite ajustar las sugerencias mediante instrucciones.
  • 04Funciona con muchos proveedores, incluidos servidores autohospedados compatibles con OpenAI.
  • 05Los atajos de teclado son configurables y no hace falta usar el mouse.
  • 06Admite configurar el idioma de las explicaciones y los encabezados HTTP personalizados.

Casos de uso

  • Consultar opciones de git, kubectl o curl sin salir de la terminal.
  • Crear una canalización de shell puntual a partir de una descripción en lenguaje natural.
  • Diagnosticar un error tipográfico o un comando fallido y obtener una versión corregida.
  • Ejecutar un modelo autohospedado para que el contexto de los comandos permanezca en tu máquina.

Inicio rápido

  1. 1

    Instala git y uv, o bien Python compatible con pip y venv

  2. 2

    Instala el plugin con fisher

    fisher install realiserad/fish-ai
  3. 3

    Crea el archivo de configuración ~/.config/fish-ai.ini con el proveedor de modelos de lenguaje que hayas elegido

Antes de usarlo

  • Necesita una clave de API de un proveedor de modelos alojados o un modelo autoalojado.
  • Envía la línea de comandos, el nombre del sistema operativo y la salida de los comandos relacionados o el contenido de los archivos al modelo de lenguaje.

En colecciones

Temas

Preguntas frecuentes

¿Qué es fish-ai?
Un plugin para Fish shell que usa LLM para convertir comentarios en comandos, explicar comandos, corregir errores tipográficos y autocompletar la línea de comandos. fish-ai es un plugin para Fish shell que conecta la línea de comandos con un modelo de lenguaje. Escribe un comentario que describa una tarea y pulsa un atajo para obtener un comando de shell, o escribe un comando y obtén un comentario que explique qué hace. Esto resulta útil con herramientas que tienen muchas opciones, como git, kubectl y curl.
¿fish-ai es gratuito? ¿Qué licencia tiene?
fish-ai es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿fish-ai sigue mantenido?
Mantenimiento activo. El último commit de fish-ai fue el 6 nov 2026.
¿Para qué puedo usar fish-ai?
Consultar opciones de git, kubectl o curl sin salir de la terminal. Crear una canalización de shell puntual a partir de una descripción en lenguaje natural. Diagnosticar un error tipográfico o un comando fallido y obtener una versión corregida. Ejecutar un modelo autohospedado para que el contexto de los comandos permanezca en tu máquina.
¿Cómo se instala fish-ai?
Instala git y uv, o bien Python compatible con pip y venv Instala el plugin con fisher: fisher install realiserad/fish-ai Crea el archivo de configuración ~/.config/fish-ai.ini con el proveedor de modelos de lenguaje que hayas elegido
¿Dónde consigo fish-ai?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Realiserad/fish-ai

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

Proyectos relacionados