Butterfish Shell est conçu pour ceux qui travaillent en terminal. Après une installation via Homebrew ou go install, lancer butterfish shell démarre une nouvelle instance de votre bash ou zsh habituel, l'outil interceptant l'entrée et la sortie standard. Dès lors, une ligne qui commence par une majuscule est dirigée vers le modèle d'IA plutôt que vers le shell : on peut demander « pourquoi cela n'a-t-il pas fonctionné ? » et le modèle voit l'historique récent et la sortie de la commande pour répondre en contexte. Aucun copier-coller entre le navigateur et le terminal.
Au-delà du prompting, l'outil propose des suggestions de commandes basées sur GPT, proches de GitHub Copilot mais dans le shell, acceptées avec Tab. Les prompts restent visibles et modifiables dans un fichier YAML au lieu d'être cachés, ce qui laisse le contrôle du texte d'instruction envoyé au modèle. Les modèles sont configurables eux aussi : un modèle OpenAI par défaut, mais n'importe quel point de terminaison compatible via un indicateur de base URL, y compris des serveurs de modèles locaux.
Goal Mode constitue la partie agentique. Commencer une commande par ! confie un objectif au modèle, qui propose des commandes à confirmer par Entrée ; commencer par !! lui permet de les exécuter sans confirmation. Le projet reconnaît franchement que ce mode est irrégulier et convient mieux à des objectifs simples et bien guidés, comme trouver des fichiers volumineux ou lister récursivement des fichiers Go. Le plugin complémentaire butterfish.nvim apporte le même style de prompting dans l'éditeur.
