butterfish

butterfish é uma ferramenta revolucionária de código aberto projetada para desenvolvedores, administradores de sistemas e qualquer pessoa que viva na linha de comando. Funciona como um invólucro de shell inteligente para bash e zsh, integrando perfeitamente o poder de Modelos de Linguagem Grandes (LLMs) como a série GPT da OpenAI diretamente no seu fluxo de trabalho do terminal. Frequentemente descrito como "GitHub Copilot para o shell", o butterfish aprimora sua experiência na linha de comando, fornecendo assistência de IA contextual, geração de comandos e automação, tudo sem sair do seu terminal.

O conceito central do butterfish é sua integração intuitiva e não intrusiva. Você continua a usar seu shell como faria normalmente, mas com um superpoder adicional: simplesmente comece qualquer comando com uma letra maiúscula para transformá-lo em um prompt para a IA. A IA tem acesso ao seu histórico recente do shell, o que lhe permite entender o contexto do seu trabalho. Isso permite que você faça perguntas de acompanhamento, depure comandos com falha e receba sugestões altamente relevantes para sua tarefa atual, eliminando o ciclo tedioso de copiar e colar erros em um mecanismo de busca.

Como usar butterfish

Começar a usar o butterfish é simples. Ele foi projetado para ambientes macOS e Linux.

1. Instalação: Você pode instalar o butterfish facilmente usando o Homebrew no macOS (brew install bakks/bakks/butterfish) ou com o Go (go install github.com/bakks/butterfish/cmd/butterfish@latest).
2. Autenticação: Na primeira execução, o butterfish solicitará uma chave de API da OpenAI. Você precisa gerar uma chave em sua conta OpenAI e colá-la. A chave é armazenada localmente em ~/.config/butterfish/butterfish.env.
3. Executando o Shell: Inicie o shell com IA executando o comando butterfish shell. É recomendável criar um alias como alias bf="butterfish" em seu .zshrc ou .bashrc para acesso mais rápido.
4. Solicitando à IA: Dentro do shell do butterfish, digite um prompt começando com uma letra maiúscula, por exemplo: Dê-me um comando para encontrar todos os arquivos .log maiores que 100MB. A IA responderá com o comando apropriado.
5. Depuração: Se um comando falhar, você pode pedir ajuda imediatamente: Por que esse comando falhou? A IA analisará a mensagem de erro e seu comando em contexto e fornecerá uma explicação e uma versão corrigida.
6. Usando o Modo Objetivo (Goal Mode): Para tarefas mais complexas, você pode ativar o Modo Objetivo iniciando um prompt com !. Por exemplo: !Instale as dependências python para este projeto e execute os testes. A IA atuará como um agente, sugerindo comandos um por um para você executar. Use !! para um modo inseguro onde ele executa comandos sem confirmação (use com cautela).
7. Sugestão Automática: Conforme você digita, o butterfish sugerirá proativamente conclusões de comando, que você pode aceitar pressionando a tecla Tab.

Recursos principais do butterfish

• Assistência de IA Consciente do Contexto: O butterfish mantém um histórico de seus comandos e suas saídas, permitindo que a IA forneça respostas e ajuda de depuração contextualmente relevantes.
• Integração Perfeita com o Shell: Ele envolve seu shell existente (bash ou zsh) sem interferir em suas configurações personalizadas, aliases ou funções.
• Geração de Comandos por IA e Sugestão Automática: Gere comandos de shell complexos a partir de descrições em linguagem natural e obtenha sugestões inteligentes no estilo Copilot enquanto digita.
• Agente Autônomo (Modo Objetivo): Um recurso poderoso onde a IA pode executar uma série de comandos para atingir um objetivo complexo, com modos para execução confirmada pelo usuário e autônoma.
• Personalização e Transparência Totais: Os usuários podem visualizar e editar os prompts do sistema enviados à IA, selecionar diferentes modelos de LLM (incluindo os locais via APIs compatíveis) e inspecionar solicitações de API brutas no modo detalhado.
• Utilitários Integrados: Inclui ferramentas CLI adicionais para resumir arquivos de texto, gerar comandos (`gencmd`) e gerenciar embeddings semânticos de arquivos locais para perguntas e respostas conscientes do código (`index`, `indexsearch`).
• Integração com Neovim: Um plugin dedicado `butterfish.nvim` traz as mesmas capacidades fluentes de prompting de LLM diretamente para o editor Neovim para tarefas como refatoração de código.
• Código Aberto: Licenciado sob a licença MIT, o butterfish é gratuito para usar, modificar e contribuir, fomentando um processo de desenvolvimento transparente e orientado pela comunidade.

Casos de uso para butterfish

O butterfish é versátil e pode ser aplicado em inúmeros cenários:

• Aprendizagem e Exploração: Iniciantes na linha de comando podem aprender ferramentas complexas como awk, sed ou `ffmpeg` descrevendo o que desejam fazer em linguagem simples.
• Depuração Eficiente: Em vez de procurar por mensagens de erro enigmáticas online, os desenvolvedores podem obter instantaneamente uma explicação e uma correção, acelerando drasticamente o ciclo de desenvolvimento.
• Criação de Comandos Complexos: Para tarefas únicas que exigem uma cadeia complicada de comandos, como encontrar, processar e mover arquivos com base em critérios específicos, o butterfish pode gerar o comando em segundos.
• Estruturação e Automação de Projetos: Use o Modo Objetivo para automatizar tarefas de configuração, como clonar um repositório, instalar dependências de um `package.json` ou `requirements.txt` e executar comandos de compilação iniciais.
• Perguntas e Respostas sobre a Base de Código: Ao indexar o código-fonte de um projeto com o comando `index`, um desenvolvedor pode fazer perguntas como indexquestion Onde a string de conexão do banco de dados é definida? para navegar e entender rapidamente um código desconhecido.

Vantagens do butterfish

A principal vantagem do butterfish é o aumento significativo na produtividade e eficiência que ele oferece. Ao integrar a IA diretamente no terminal, ele elimina a troca de contexto e otimiza os fluxos de trabalho. Ele capacita tanto usuários novatos quanto experientes, tornando a linha de comando mais acessível e poderosa. Seu compromisso com a transparência e a personalização permite que os usuários adaptem a ferramenta às suas necessidades específicas e confiem em suas operações. Finalmente, ser de código aberto garante que ele permaneça uma ferramenta gratuita, apoiada pela comunidade, que evolui com o feedback do usuário.

Preços e planos

O butterfish em si é uma ferramenta completamente gratuita e de código aberto, disponível sob a Licença MIT. Não há taxas de assinatura ou cobranças pelo uso do software. No entanto, para funcionar, o butterfish requer uma chave de API de um provedor de LLM, sendo a OpenAI o padrão. Os usuários são responsáveis pelos custos associados ao seu próprio uso da API. O custo depende do modelo escolhido e da frequência de uso (por exemplo, a sugestão automática consome mais API). A ferramenta oferece opções para gerenciar custos, como ajustar os tempos de espera da sugestão automática, desativá-la ou usar modelos mais econômicos.