butterfish

butterfish es una revolucionaria herramienta de código abierto diseñada para desarrolladores, administradores de sistemas y cualquiera que viva en la línea de comandos. Funciona como un envoltorio de shell inteligente para bash y zsh, integrando a la perfección el poder de los Grandes Modelos de Lenguaje (LLM) como la serie GPT de OpenAI directamente en tu flujo de trabajo de la terminal. A menudo descrito como "GitHub Copilot para el shell", butterfish mejora tu experiencia en la línea de comandos al proporcionar asistencia de IA contextual, generación de comandos y automatización, todo sin salir de tu terminal.

El concepto central de butterfish es su integración intuitiva y no intrusiva. Continúas usando tu shell como lo harías normalmente, pero con un superpoder añadido: simplemente comienza cualquier comando con una letra mayúscula para convertirlo en una instrucción para la IA. La IA tiene acceso a tu historial reciente del shell, lo que le permite entender el contexto de tu trabajo. Esto te permite hacer preguntas de seguimiento, depurar comandos fallidos y recibir sugerencias que son altamente relevantes para tu tarea actual, eliminando el tedioso ciclo de copiar y pegar errores en un motor de búsqueda.

Cómo usar butterfish

Empezar a usar butterfish es muy sencillo. Está diseñado para entornos de macOS y Linux.

1. Instalación: Puedes instalar butterfish fácilmente usando Homebrew en macOS (brew install bakks/bakks/butterfish) o con Go (go install github.com/bakks/butterfish/cmd/butterfish@latest).
2. Autenticación: En la primera ejecución, butterfish te pedirá una clave de API de OpenAI. Necesitas generar una clave desde tu cuenta de OpenAI y pegarla. La clave se almacena localmente en ~/.config/butterfish/butterfish.env.
3. Ejecutando el Shell: Lanza el shell con IA ejecutando el comando butterfish shell. Se recomienda crear un alias como alias bf="butterfish" en tu .zshrc o .bashrc para un acceso más rápido.
4. Preguntando a la IA: Dentro del shell de butterfish, escribe una instrucción comenzando con una letra mayúscula, por ejemplo: Dame un comando para encontrar todos los archivos .log de más de 100MB. La IA responderá con el comando apropiado.
5. Depuración: Si un comando falla, puedes pedir ayuda inmediatamente: ¿Por qué falló ese comando? La IA analizará el mensaje de error y tu comando en contexto y proporcionará una explicación y una versión corregida.
6. Usando el Modo Objetivo (Goal Mode): Para tareas más complejas, puedes activar el Modo Objetivo comenzando una instrucción con !. Por ejemplo: !Instala las dependencias de python para este proyecto y ejecuta las pruebas. La IA actuará como un agente, sugiriendo comandos uno por uno para que los ejecutes. Usa !! para un modo inseguro donde ejecuta comandos sin confirmación (úsalo con precaución).
7. Autosugerencia: Mientras escribes, butterfish sugerirá proactivamente completaciones de comandos, que puedes aceptar presionando la tecla Tab.

Características principales de butterfish

• Asistencia de IA Consciente del Contexto: butterfish mantiene un historial de tus comandos y sus salidas, permitiendo que la IA proporcione respuestas y ayuda de depuración contextualmente relevantes.
• Integración Perfecta con el Shell: Envuelve tu shell existente (bash o zsh) sin interferir con tus configuraciones personalizadas, alias o funciones.
• Generación de Comandos por IA y Autosugerencia: Genera comandos de shell complejos a partir de descripciones en lenguaje natural y obtén sugerencias inteligentes al estilo Copilot mientras escribes.
• Agente Autónomo (Modo Objetivo): Una potente función donde la IA puede ejecutar una serie de comandos para alcanzar un objetivo complejo, con modos para ejecución confirmada por el usuario y autónoma.
• Personalización y Transparencia Totales: Los usuarios pueden ver y editar las instrucciones del sistema enviadas a la IA, seleccionar diferentes modelos de LLM (incluidos los locales a través de APIs compatibles) e inspeccionar las solicitudes de API en bruto en modo detallado.
• Utilidades Integradas: Incluye herramientas CLI adicionales para resumir archivos de texto, generar comandos (`gencmd`) y gestionar incrustaciones semánticas de archivos locales para preguntas y respuestas conscientes del código (`index`, `indexsearch`).
• Integración con Neovim: Un plugin dedicado `butterfish.nvim` lleva las mismas capacidades fluidas de instrucción de LLM directamente al editor Neovim para tareas como la refactorización de código.
• Código Abierto: Con licencia MIT, butterfish es gratuito para usar, modificar y contribuir, fomentando un proceso de desarrollo transparente e impulsado por la comunidad.

Casos de uso para butterfish

butterfish es versátil y se puede aplicar en numerosos escenarios:

• Aprendizaje y Exploración: Los recién llegados a la línea de comandos pueden aprender herramientas complejas como awk, sed o `ffmpeg` describiendo lo que quieren hacer en lenguaje sencillo.
• Depuración Eficiente: En lugar de buscar mensajes de error crípticos en línea, los desarrolladores pueden obtener instantáneamente una explicación y una solución, acelerando drásticamente el ciclo de desarrollo.
• Creación de Comandos Complejos: Para tareas puntuales que requieren una cadena complicada de comandos, como encontrar, procesar y mover archivos según criterios específicos, butterfish puede generar el comando en segundos.
• Andamiaje y Automatización de Proyectos: Usa el Modo Objetivo para automatizar tareas de configuración, como clonar un repositorio, instalar dependencias de un `package.json` o `requirements.txt` y ejecutar comandos de compilación iniciales.
• Preguntas y Respuestas sobre la Base de Código: Al indexar el código fuente de un proyecto con el comando `index`, un desarrollador puede hacer preguntas como indexquestion ¿Dónde se define la cadena de conexión de la base de datos? para navegar y entender rápidamente código desconocido.

Ventajas de butterfish

La principal ventaja de butterfish es el significativo aumento de productividad y eficiencia que ofrece. Al integrar la IA directamente en la terminal, elimina el cambio de contexto y agiliza los flujos de trabajo. Empodera tanto a usuarios novatos como a expertos, haciendo la línea de comandos más accesible y potente. Su compromiso con la transparencia y la personalización permite a los usuarios adaptar la herramienta a sus necesidades específicas y confiar en sus operaciones. Finalmente, ser de código abierto asegura que siga siendo una herramienta gratuita, apoyada por la comunidad, que evoluciona con los comentarios de los usuarios.

Precios y planes

butterfish en sí es una herramienta completamente gratuita y de código abierto, disponible bajo la Licencia MIT. No hay tarifas de suscripción ni cargos por usar el software. Sin embargo, para funcionar, butterfish requiere una clave de API de un proveedor de LLM, siendo OpenAI el predeterminado. Los usuarios son responsables de los costos asociados con su propio uso de la API. El costo depende del modelo elegido y la frecuencia de uso (por ejemplo, la autosugerencia consume más API). La herramienta ofrece opciones para gestionar los costos, como ajustar los tiempos de espera de la autosugerencia, desactivarla o usar modelos más económicos.