Butterfish Shell richtet sich an Menschen, die im Terminal arbeiten. Nach der Installation über Homebrew oder go install startet butterfish shell eine neue Instanz der gewohnten bash oder zsh, wobei das Werkzeug die Standardein- und -ausgabe abfängt. Ab dann wird eine Zeile, die mit einem Großbuchstaben beginnt, nicht an die Shell, sondern an das KI-Modell geleitet: Man kann fragen „Warum hat das nicht funktioniert?“ und das Modell sieht den jüngsten Verlauf samt Befehlsausgabe und antwortet im Kontext. Kein Kopieren und Einfügen zwischen Browser und Terminal.
Neben dem Prompting gibt es GPT-gestützte Befehlsvorschläge, ähnlich GitHub Copilot, aber innerhalb der Shell, die man mit Tab übernimmt. Die Prompt-Vorlagen liegen sichtbar und editierbar in einer YAML-Datei statt verborgen zu sein, sodass man den an das Modell gesendeten Instruktionstext kontrolliert. Auch die Modelle sind konfigurierbar: Standard ist ein OpenAI-Modell, doch über ein Base-URL-Flag lässt sich jeder OpenAI-kompatible Endpunkt ansprechen, einschließlich lokal gehosteter Modelle.
Goal Mode ist der agentische Teil. Ein Befehl, der mit ! beginnt, übergibt dem Modell ein Ziel, das Befehle vorschlägt, die man mit Enter bestätigt; mit !! darf es sie ohne Bestätigung ausführen. Das Projekt sagt offen, dass dieser Modus unzuverlässig ist und für einfache, gut geführte Ziele wie das Finden großer Dateien oder das rekursive Auflisten von Go-Dateien am besten geeignet ist. Das begleitende Neovim-Plugin butterfish.nvim bringt denselben Prompting-Stil in den Editor.
