Butterfish CLI Tools

Descrição

Butterfish é um conjunto de ferramentas de interface de linha de comando (CLI) projetadas para aumentar a produtividade de engenheiros de software e usuários de linha de comando, integrando Large Language Models (LLMs) diretamente em seu fluxo de trabalho. A oferta principal, Butterfish Shell, transforma seu shell existente (bash, zsh) em um assistente com IA. Ao simplesmente iniciar um comando com uma letra maiúscula, os usuários podem fazer prompts para a IA com perguntas contextuais, aproveitando o histórico do shell para assistência relevante sem a necessidade de copiar e colar.

Esta ferramenta atua como um "wrapper de shell", interceptando entrada e saída para fornecer recursos de IA. Os usuários podem solicitar comandos, perguntar sobre falhas de comando ou até mesmo usar o "Modo de Objetivo" (iniciado com '!') onde a IA atua como um agente para executar comandos e atingir um objetivo especificado, com um "Modo de Objetivo Inseguro" (iniciado com '!!') para execução automatizada. Butterfish Shell oferece recursos como autocompletar comandos, semelhante ao GitHub Copilot, e mantém o histórico de conversas, permitindo o refinamento iterativo de comandos ou respostas gerados por IA.

Além da integração do shell, Butterfish inclui outras utilidades, como um cliente de prompt direto, um gerador de comandos, um sumarizador de arquivos e ferramentas para gerenciar embeddings de arquivos locais. O projeto enfatiza a transparência, permitindo que os usuários visualizem e personalizem os prompts enviados para a IA por meio de arquivos de configuração. Ele suporta APIs compatíveis com OpenAI, permitindo o uso de provedores de LLM locais ou alternativos. Butterfish é de código aberto, licenciado sob a licença MIT, e acolhe contribuições da comunidade.

O público-alvo inclui desenvolvedores, administradores de sistemas e qualquer pessoa que trabalhe frequentemente na linha de comando e busque alavancar a IA para conclusão de tarefas mais rápida, depuração e geração de código. A proposta de valor reside em sua integração perfeita em fluxos de trabalho existentes, reduzindo a troca de contexto e fornecendo assistência de IA de alto contexto precisamente quando e onde ela é necessária.

Recursos principais de Butterfish CLI Tools

• Integração de shell com IA para bash e zsh

• Prompt de IA contextual usando histórico do shell

• Autocompletar comandos no estilo GitHub Copilot

• Modo de Objetivo para execução de comandos orientada por IA

• Modo de Objetivo Inseguro para execução automatizada de comandos

• Prompts de IA e mensagens do sistema personalizáveis

• Suporte para APIs compatíveis com OpenAI e modelos locais

• Capacidades de sumarização de arquivos e embedding de texto

• Registro transparente de requisições e respostas de IA

• Código aberto sob a licença MIT

Como usar Butterfish CLI Tools?

1. 1

   Instalar: Use o Homebrew no macOS (`brew install bakks/bakks/butterfish`) ou `go install`.

2. 2

   Autenticar: Execute `butterfish shell` e cole sua chave secreta da API OpenAI quando solicitado.

3. 3

   Configurar: Opcionalmente, crie um alias `butterfish` para `bf` no arquivo rc do seu shell para conveniência.

4. 4

   Usar Modo Shell: Inicie comandos com uma letra maiúscula para prompts de IA ou '!' para o Modo de Objetivo.

5. 5

   Autossugestão: Pressione Tab para aceitar sugestões de autocompletar de comandos da IA.

6. 6

   Depurar: Faça perguntas contextuais como 'Por que esse comando falhou?'

7. 7

   Sumarizar: Use `butterfish summarize <arquivos>` para obter resumos semânticos de arquivos.

Casos de uso de Butterfish CLI Tools

• Assistente de Shell com IA
• Geração de Comandos
• Sumarização de Arquivos
• Depuração de Código
• Prompt Contextual
• Execução de Tarefas Agentes
• Integração de LLM Local
• Gerenciamento de Embeddings de Texto

Perguntas frequentes de Butterfish CLI Tools

• O que é Butterfish e o que ele faz?

  Butterfish é um conjunto de ferramentas CLI que integram prompts de IA em seu fluxo de trabalho de linha de comando, oferecendo recursos como comandos de shell assistidos por IA, autocompletar e execução de tarefas orientada a objetivos.

• Como o Butterfish Shell adiciona superpoderes de IA ao meu terminal?

  Butterfish Shell envolve seu shell existente (bash, zsh) e permite que você faça prompts para a IA iniciando comandos com uma letra maiúscula. Ele usa seu histórico de shell para fornecer assistência de IA contextual.

• O Butterfish pode me ajudar a depurar comandos?

  Sim, você pode fazer perguntas contextuais como 'Por que esse comando falhou?' após a execução de um comando, e o Butterfish usará a IA para ajudar a diagnosticar o problema.

• O que é o Modo de Objetivo no Butterfish?

  O Modo de Objetivo, iniciado com '!', permite que a IA atue como um agente. Você fornece um objetivo, e a IA sugerirá e executará comandos para alcançá-lo, usando seu histórico de shell para contexto.

• Como instalo o Butterfish?

  Butterfish pode ser instalado no macOS e Linux. No macOS, você pode usar o Homebrew (`brew install bakks/bakks/butterfish`). Alternativamente, você pode usar `go install`.

• O Butterfish requer uma chave de API OpenAI?

  Sim, Butterfish usa APIs OpenAI por padrão. Você precisará fornecer sua chave secreta da API OpenAI durante a primeira invocação de `butterfish shell`.

• Posso usar o Butterfish com LLMs locais ou outros provedores de API?

  Sim, Butterfish suporta APIs compatíveis com OpenAI. Você pode usar o flag `--base-url` para apontar para um modelo local ou outro endpoint de API compatível.

• O Butterfish é de código aberto?

  Sim, Butterfish é um projeto de código aberto licenciado sob a licença MIT.

• Quais são as outras utilidades fornecidas pelo Butterfish além do wrapper de shell?

  Butterfish também inclui utilidades para prompt direto de LLM, geração de comandos de shell, sumarização semântica de arquivos e gerenciamento de embeddings de arquivos locais.

• Como o Butterfish lida com saídas de comandos longas ou histórico?

  Butterfish gerencia o histórico dentro dos limites de tokens para requisições de API. Saídas de comandos longas são truncadas para um limite de tokens configurável, e itens de histórico mais antigos podem ficar fora da janela de contexto.

• Posso personalizar os prompts enviados para a IA?

  Sim, Butterfish torna os prompts transparentes e configuráveis. Você pode editar os wrappers de prompt localizados em `~/.config/butterfish/prompts.yaml`.

• O que é o "Modo de Objetivo Inseguro"?

  O Modo de Objetivo Inseguro, iniciado com '!!', permite que a IA execute comandos sem confirmação. Este modo é potencialmente perigoso e deve ser usado com cautela.