Butterfish

Eine kurze Beschreibung

Butterfish ist eine open-source Shell-Verpackung, die für bash und zsh Funktionen wie KI-basierte Fragen beantworten, Befehle generieren, automatische Vervollständigung sowie Agentenausführung hinzufügt. Dadurch erhalten Benutzer kontextbezogene Hilfe, ohne den Terminalausgang kopieren zu müssen.

Die Software selbst wird unter der MIT-Lizenz bereitgestellt und ist kostenlos, erfordert jedoch standardmäßig einen eigenen OpenAI-API-Schlüssel des Benutzers. Die durch den Aufruf der Modelle entstehenden Tokens sowie die Kosten für die Serviceebene werden vom Benutzer getragen.

Was ist Butterfish?

Butterfish Shell wird von Peter Bakkum gewartet und richtet sich hauptsächlich an Entwickler sowie Administratoren, die dauerhaft in macOS- oder Linux-Terminals arbeiten. Es ersetzt die Systemshell nicht, sondern startet eine zusätzliche Session über den vorhandenen bash- oder zsh-Shell und leitet Eingaben sowie Ausgaben um.

Allgemeine Befehle werden weiterhin von Shell ausgeführt, während Eingaben in natürlicher Sprache, die mit Großbuchstaben beginnen, an das Modell gesendet werden. Butterfish berücksichtigt die jüngsten Befehle, Ausgaben sowie frühere Gespräche im Kontext – dadurch kann man direkt fragen, warum ein vorheriger Befehl fehlgeschlagen ist.

Aktueller Wartungszustand

Stand dem 20. August 2026 ist die neueste offizielle Version auf GitHub v0.4.3. Zu den in dieser Version behobenen Problemen gehören die Verarbeitung von Eingaben durch den Agenten, Hinweise bei der Startung des Shells sowie eine automatische Vervollständigung mit geringer Verzögerung. Auf der Seite zu den Go-Modulen wird ebenfalls v0.4.3 aufgeführt, wobei die MIT-Lizenz bestätigt wird.

Das Projekt befindet sich noch in der 0.x-Version, sodass keine Kompatibilität unter der Annahme einer stabilen 1.0-Schnittstelle angenommen werden kann. Vor dem Upgrade sollten die Änderungen gelesen, die Konfigurationen der benutzerdefinierten Anzeigen beibehalten sowie die Interaktion mit dem Shell und die Parameter des Modells in nicht kritischen Umgebungen getestet werden.

Hauptfunktionen

Frage-Antwort im Kontextterminal

In Butterfish Shell kann man dem Modell Fragen stellen, indem man mit Großbuchstaben beginnt. Die kürzlich eingegebenen Anfragen, Ausgaben sowie die Antworten der KI werden im Kontext gespeichert – das erleichtert die Erklärung von Fehlern, weitere Nachfragen sowie die Empfehlung von nächsten Schritten basierend auf dem aktuellen Verzeichnis.

Befehl zur automatischen Vervollständigung

Wenn der Benutzer Befehle eingibt, kann Butterfish anhand der Shell-Historie sowie früherer AI-Empfehlungen den vollständigen Befehl vorhersagen und diesen mit Tab akzeptieren. Die automatische Vervollständigung sendet häufig Anfragen an das Modell, was sowohl Kosten verursachen kann als auch sensible eingetippte Inhalte an den Modellservice übertragen wird.

Agent Mode

Wenn eine Aufgabe mit einem einzelnen Ausrufezeichen beginnt, tritt der Agent-Modus in Kraft. In diesem Modus kann das Modell wiederholt Befehle ausführen und diese anhand der Ergebnisse anpassen. Im aktuellen Sicherheitsmodus bleibt die manuelle Bestätigung erforderlich, während zwei Ausrufezeichen den gefährlichen Modus ohne Bestätigung einleiten.

Action Mode

Eine Anfrage, die mit einem einzelnen @ beginnt, veranlasst das Modell, genau einen Shell-Befehl zu erzeugen, der zunächst im Terminal angezeigt wird, damit der Benutzer ihn überprüfen kann. Zwei @ führen das Ergebnis sofort aus; dies sollte nur in Fällen in Betracht gezogen werden, in denen Ziel, Verzeichnis und Nebeneffekte klar definiert sind.

Unabhängige Prompt-Befehle

Der Prompt-Subbefehl kann direkt Text senden oder Eingaben über Pipes zusammen mit Anweisungen verwenden, um die Ergebnisse des Modells in Form eines Flussdatenstroms zurückzugeben. Er eignet sich zur Erklärung von Konfigurationen, zum Zusammenfassen von Texten oder zur Durchführung einmaliger Fragen und Antworten außerhalb von Skripten.

Die gencmd-Anweisung erzeugt.

gencmd wandelt natürliche Sprache in Shell-Befehle um und ermöglicht es den Benutzern, die Ergebnisse zunächst zu überprüfen. Die erzwungene Option überspringt die Bestätigung und führt den generierten Befehl direkt aus, was bei Operationen wie Löschung, Überschreiben, Netzwerkdownloaden und Berechtigungsanpassungen ein hohes Risiko darstellt.

exec-Fehlerbehebung

„exec“ wird verwendet, um eine bestimmte Anweisung auszuführen. Im Falle eines Fehlers wird eine Analyse des Modells durchgeführt und es werden Vorschläge zur Behebung des Problems gegeben. Dadurch können die Schritte zur Kopie der Fehlerprotokolle reduziert werden. Dennoch sollten die Vorschläge immer manuell überprüft werden – unter Berücksichtigung des Betriebssystems, der Version der Tools sowie des Status des Projekts.

• Direkte KI-Fragen und -Antworten mit Shell-Historiekontext direkt im Terminal.
• Automatische Tab-Erweiterung basierend auf der aktuellen Eingabe und kürzlichen Befehlen.
• Natürliche Sprache in überprüfbare Shell-Befehle umwandeln.
• Führen Sie den Befehl aus und erstellen Sie auf der Grundlage der Fehlerausgabe Korrekturvorschläge.
• Verwenden Sie den Agent-Modus, um mehrstufige Ziele in Schleifen auszuführen und zu debuggen.
• Verwenden Sie den Action Mode, um einen Befehl zu erstellen, der für die aktuelle Aufgabe geeignet ist.
• Überprüfen und bearbeiten Sie die Systemhinweise sowie Befehle, die an das Modell gesendet werden.
• Kompatible Modellservices zur Anbindung an OpenAI oder zur Implementierung einer fließenden Responses-Schnittstelle.
• Über die Standard-Eingabe werden Dateien oder andere Befehle an das Modell zur Verarbeitung übergeben.

Wie funktioniert der Shell-Modus?

1. Der Benutzer startet die Butterfish Shell, wodurch im Wrapper der ursprüngliche bash oder zsh gestartet wird.
2. Die normale Tastatureingabe und die Befehlsausgabe werden weiterhin im Terminal angezeigt und im Speicherarchiv gespeichert.
3. Normale Befehle werden direkt an die Shell weitergeleitet, während Großschreibungshinweise und Präfixe für spezielle Modi von Butterfish abgefangen werden.
4. Beim Senden einer Modellanfrage nutzt das Programm Systeminformationen, Hinweistemplates sowie den Kontext der jüngsten Historie.
5. Die Anfrage soll über die OpenAI Responses-Schnittstelle oder einen kompatiblen Server gesendet werden, und die Ergebnisse sollen strömungsbasiert an das Terminal zurückgeschrieben werden.
6. Wenn das Modell Befehle vorschlägt, legt der Sicherheitsmodus diese zunächst in die Shell, damit der Benutzer sie überprüfen und bearbeiten kann.
7. Der Benutzer kann fortfahren, weitere Fragen stellen oder beenden; der aktuelle Sitzungshistorie wird im Kontextfenster abgeschnitten und strukturiert.

Die Speichergeschichte bedeutet nicht, dass die Daten niemals das Gerät verlassen. Sobald eine AI-Anfrage gestartet wird, werden die im Kontext ausgewählten Befehle, Ausgaben, Hinweise sowie Systeminformationen an den konfigurierten Modellserver gesendet.

Installationsanleitung

Über Homebrew installieren

MacOS-Nutzer können Homebrew Tap, das vom Betreiber bereitgestellt wird, verwenden, um es zu installieren, und anschließend die Butterfish Shell starten. Nach der Installation sollten sie zunächst die Version sowie die Hilfethinweise überprüfen, um sicherzustellen, dass tatsächlich die erwartete Binärdatei verwendet wird.

1. Überprüfen Sie, ob das Gerät eine unterstützte macOS-Version verwendet und ob Homebrew bereits installiert ist.
2. Installieren Sie Butterfish über den Tap des Betreibers – verwenden Sie keine Software-Pakete mit dem gleichen Namen aus unklaren Quellen.
3. Führen Sie den Befehl für die Version aus und überprüfen Sie ihn mit der neuesten offiziellen Veröffentlichung.
4. Beim ersten Starten im Shell-Modus konfigurieren Sie gemäß den Anweisungen die API-Schlüssel für das Modell.
5. Führen Sie im temporären Verzeichnis gewöhnliche Befehle sowie einfache Fragen und Antworten aus, um zu überprüfen, dass es keine Anomalien bei der Eingabe- und Ausgabeverarbeitung durch die Shell gibt.
6. Es wird bestätigt, dass im Sicherheitsmodus vor der Ausführung des Erstellungsbefehls eine manuelle Überprüfung erfolgt.

Über Go installieren

Auch macOS und Linux können die Go-Toolchain nutzen, um die neuesten Module zu installieren – das eignet sich für Nutzer, die nicht Homebrew verwenden oder von Quellcode aus bauen möchten. Die nach der Installation entstehenden Binärdateien befinden sich in der Regel im bin-Verzeichnis der Go-Umgebung; es muss sichergestellt werden, dass dieses Verzeichnis im PATH enthalten ist.

1. Installieren Sie die derzeit verfügbare Go-Toolchain und überprüfen Sie den Go-Umgebungsordner.
2. Installieren Sie die neuesten Butterfish-Befehle über den offiziellen Modulpfad.
3. Fügen Sie den bin-Ordner von Go zum PATH hinzu und öffnen Sie das Terminal erneut.
4. Überprüfen Sie die Butterfish-Version, die Lizenz und die Hilfemitteilungen.
5. Konfigurieren Sie beim ersten Start den Schlüssel und testen Sie die Verbindung mit Tests ohne Nebeneffekte.

Erste Konfiguration und API-Schlüssel

Beim ersten Aufruf verlangt Butterfish einen OpenAI-API-Schlüssel und speichert ihn in den Konfigurationsdateien des Benutzers. Der Schlüssel stammt nicht aus der ChatGPT-Web-Abonnement-Registrierung; ob ein Guthaben sowie Zugriffsrechte vorhanden sind, hängt von dem eigenständigen API-Konto ab.

• Verwenden Sie nur Projekt-Schlüssel mit kontrollierten Berechtigungen und Limits – wiederverwenden Sie keine Produkt-Schlüssel mit hohen Berechtigungen.
• Beschränken Sie die Systemrechte für die Konfigurationsverzeichnisse und Schlüsseldateien, um zu verhindern, dass andere lokale Benutzer darauf zugreifen können.
• Übergeben Sie den Konfigurationsordner nicht an Git, synchronisieren Sie ihn nicht in einen öffentlichen Cloud-Speicher oder kopieren Sie ihn nicht in Berichte über Probleme.
• Sobald ein Schlüssel in Logs, Screenshots oder über Terminal-Teilen entdeckt wird, sollte er umgehend zurückgenommen und ersetzt werden.
• Beim Verbinden mit einem kompatiblen Server wird sichergestellt, dass der Schlüssel zusammen mit der Anfrage an diesen Server gesendet wird.
• Den Teamgeräten sollten getrennt voneinander Schlüssel und Budgets zugeteilt werden, um Audits durchzuführen und ungewöhnlichen Verbrauch zu stoppen.

Tutorials für den täglichen Gebrauch

1. Gehen Sie in den Projektordner und starten Sie die Butterfish Shell. Überprüfen Sie zunächst mit einfachen Befehlen den aktuellen Zustand.
2. Bei Fehlern sollte man in natürlicher Sprache und in Großbuchstaben nach dem Grund fragen und vom Modell eine Erklärung verlangen, anstatt es sofort zu beheben.
3. Überprüfen Sie die Befehle, Pfade, Tool-Versionen sowie die Unterschiede im Betriebssystem der Antwortquellen.
4. Wenn ein Befehl benötigt wird, sollte der sichere Action Mode verwendet werden, damit das Ergebnis zunächst in die Konsole gelangt und nicht direkt ausgeführt wird.
5. Für komplexe Aufgaben kann der Agent-Modus verwendet werden, wobei die Befehle und Ausgaben jedes Mal überprüft werden.
6. Nach Abschluss prüfen, ob sensible Protokolle erzeugt wurden, und die Shell verlassen.

Sichere Verwendung von Agenten und Aktionen

Im automatischen Ausführungsmodus können Dateien gelöscht, Daten überschrieben, Geheimnisse hochgeladen, Schadsoftware installiert oder Systemrechte geändert werden. Auch wenn eine Aufgabe einfach erscheint, sollte sie nicht auf Produktivservern, in Admin-Shells oder in Verzeichnissen mit ungesicherten Daten aktiviert werden.

• Führen Sie zunächst eine nur-Lese-Prüfung durch, bevor Sie Schreib-, Installier-, Verschiebungs- oder Löschvorgänge in Betracht ziehen.
• Beschränken Sie den Einflussbereich mit normalen Benutzern, Containern, temporären Branches oder einmaligen virtuellen Umgebungen.
• Vor der Ausführung werden Variablen, Wildcards, rekursive Ziele und der aktuelle Arbeitsverzeichnis ausgeklappt.
• Manuelle Überprüfung bei dem Herunterladen und Ausführen von Skripten, der Erhöhung von Berechtigungen sowie von Befehlen für die Festplatte.
• Wichtige Änderungen sollten zunächst dem Versionskontrollsystem übergeben oder eine überprüfbare Kopie erstellt werden.
• Betrachten Sie die Antworten des Modells nicht als Anweisungen für eine Sicherheitsprüfung oder Zugriffsberechtigung.

Modellauswahl und lokale Modelle

Die aktuellen Dokumente zur Hauptbranch von GitHub geben für die Standardmodelle von Shell und Prompt GPT-5.5 an und verwenden eine hohe Inferenzstärke. Im Schnellmodus wird außerdem die Priority-Servicelayer der Responses API angefordert. Benutzer können Modelle, Inferenzstärke, maximale Ausgabe und Servicelayer mit Parametern überschreiben.

Auf den älteren Seiten der offiziellen Website werden weiterhin Beispiele für GPT-4 Turbo und GPT-3.5 Turbo angezeigt – dies handelt sich dabei um historische Dokumente. Die tatsächlichen Standardwerte sollten anhand der Hilfetexte der installierten Version sowie des aktuellen Repositoriums bestimmt werden, da sich die Namen der Modelle und ihre Verfügbarkeit je nach API-Plattform ändern können.

Butterfish kann auch lokale oder entfernte Server verbinden, die eine mit OpenAI kompatible Response-Stream-Schnittstelle bereitstellen. Die Kompatibilität erfordert nicht nur ähnliche Pfade, sondern auch eine korrekte Implementierung der Stream-Ergebnisse; die Prompt-Vorlagen sind hauptsächlich für OpenAI optimiert, wodurch die Leistung lokaler Modelle deutlich unterschiedlich sein kann.

Preise und Nutzungskosten

Das Butterfish-Programm selbst ist kostenlos – es gibt weder offizielle Mitgliedspläne noch monatliche Gebühren oder Preise pro Nutzer. Die MIT-Lizenz erlaubt die Nutzung, Änderung und Verteilung unter bestimmten Bedingungen. Die tatsächlichen Kosten für die Nutzer entstehen hauptsächlich durch die Nutzung der Modell-APIs, den Zugang zu priorisierten Diensten, die lokale Rechenleistung sowie die Wartung.

Nach Aktivierung der automatischen Vervollständigung können während der Pausen häufig Anfragen an das Modell gestellt werden – das ist eine der Hauptquellen für den täglichen Datenaufkommen. Man kann die automatische Vervollständigung deaktivieren oder die Wartezeit zwischen den Anfragen verlängern sowie unerwünschte Prioritäts-Ebenen deaktivieren.

Hinweise zu Transparenz und Anpassung

Butterfish speichert die Systembenachrichtigungen, die erzeugten Befehle sowie die Vorschläge für die automatische Ergänzung in einer YAML-Konfiguration – diese kann von den Benutzern angezeigt und bearbeitet werden. Bei geänderten Einträgen sollte das Kontrollkästchen für die automatische Ersetzung deaktiviert werden, da sonst die Programme beim Aktualisieren der Vorschlagsdatenbank die benutzerdefinierten Versionen überschreiben könnten.

• Überprüfen Sie, ob die Shell-Systemmeldungen mit den Sicherheitsrichtlinien und dem Befehlssyntax-Stil des Teams übereinstimmen.
• Es wird verlangt, dass Befehle Standard-Erklärungsparameter, Pfade und Nebenwirkungen erzeugen.
• Legen Sie klare Regeln fest, die eine automatische Ausführung für Produktion, Datenbanken und Cloud-Ressourcen verbieten.
• Nach dem Upgrade ändern sich die Standardhinweise; behalten Sie keine veralteten Vorlagen blindlings bei.
• Verwenden Sie Versionskontrolle, um die maskierten Hinweisdateien zu speichern, ausschließlich Schlüssel und lokale Pfade ausgenommen.
• Hinweissysteme können nur die Wahrscheinlichkeit von Fehlbedienungen verringern, sie ersetzen jedoch nicht die Rechte des Betriebssystems sowie die manuelle Freigabe.

Privatsphäre und Datensicherheit

Butterfish ist eine lokale, open-source CLI ohne zentrales Butterfish-Konto oder einen Dienst zur Speicherung von Chat-Verläufen. Anfragen an das Modell senden weiterhin den ausgewählten Shell-Verlauf, die Ausgaben der Befehle, Systeminformationen, Benachrichtigungen für den Benutzer sowie die AI-Gespräche an den konfigurierten API-Endpunkt.

Im detaillierten Modus können die vollständigen Anfragen und Antworten in der Konsole ausgegeben oder in dem temporären Log-Verzeichnis des Systems gespeichert werden. Die Ausgaben in der Konsole enthalten in der Regel den Zugriffstoken, Umgebungsvariablen, Datenbankinhalte sowie Kundendaten. Debug-Logs sollten als sensible Dateien betrachtet werden.

• Führen Sie keine Kontextfragen direkt nach der Anzeige von Schlüsseln, Produktionsdatenbanken oder Kundendaten durch.
• Vor dem Teilen von Terminals, dem Aufnehmen von Bildschirmaufnahmen und dem Melden von Problemen sollten die Butterfish-Logs sowie die Shell-Ausgaben bereinigt werden.
• Prüfen Sie bei der Verbindung mit Drittanbietern oder lokalen kompatiblen Endpunkten deren Protokolle sowie Richtlinien zur Schulung und Aufbewahrung.
• Die Beschränkung des historischen Fensters garantiert nicht, dass Geheimnisse vollständig ausgeschlossen werden; man sollte aktiv vermeiden, sie in der Sitzung preiszugeben.
• Entfernte Server sollten eine verschlüsselte Übertragung verwenden; Authentifizierungstoken dürfen nicht an unzuverlässige Adressen gesendet werden.
• Im Unternehmensumfeld sollten zunächst die Richtlinien für die Nutzung von Code-, Daten- und Modellanbietern festgelegt werden.

Unterstützungssysteme und Abhängigkeiten

Für welche Benutzer geeignet

• Anfänger in der Kommandozeile: Sie erhalten Erklärungen zu Befehlen und zu den Ursachen von Fehlern, müssen aber dennoch die Grundlagen der Shell erlernen.
• Softwareentwickler: Fragen weiterhin anhand des aktuellen Verzeichnisses, der Build-Ausgabe und fehlgeschlagener Tests.
• DevOps-Engineer: Erstellt nur lesbare Diagnosebefehle und analysiert Protokolle; Produktivänderungen müssen weiterhin genehmigt werden.
• Open-Source-Enthusiasten: Überprüfung des Quellcodes, Vorschläge für Vorlagen und Logik zur Übertragung von Daten.
• Lokaler Modellnutzer: Verbinden Sie den Terminal-Assistenten mit einem lokalen Dienst, der eine kompatible Responses-Schnittstelle bietet.
• Teams, die anpassbare Hinweise benötigen: Schreiben Sie den Befehlssyntax-Stil sowie die Sicherheitsanforderungen in eine transparente Hinweissammlung.

Typische Anwendungsszenarien

• Erklären Sie den gerade fehlgeschlagenen Build-, Test-, Paketverwaltungs- oder Git-Befehl.
• Erstellen von nur zum Lesen bestimmten Befehlen zur Suche nach Dateien, Anzeige von Ports, Auswertung von Verzeichnissen und Filtern von Protokollen.
• Übergeben Sie die Konfigurationsdatei oder die Ausgabe der Befehle per Pipe an die Modellzusammenfassung.
• Anpassen Sie die Parameter je nach Version des Tools und erklären Sie die Funktion jedes Flags.
• Lassen Sie den Agent in der temporären Branch Tests ausführen und versuchen, einfache Probleme zu beheben.
• Verwenden Sie lokale Modelle zur Verarbeitung von internen, geringrisikobehafteten Aufgaben, die nicht für den Versand in die öffentliche Cloud geeignet sind.

Vorteile des Produkts

• Nutzen Sie direkt die Shell-Geschichte, um Kopierbefehle, Fehler sowie Hin- und Herbewegungen im Kontext zu reduzieren.
• Die vorhandenen Bash- oder Zsh-Pakete bleiben unverändert, und die üblichen Befehlskonventionen bleiben im Grunde gleich.
• Frage-Antwort-, Ein-Befehl- und Mehrschritt-Agenten haben klare unterschiedliche Eingabeprefixe.
• Hinweistexte und Anfragen für das ursprüngliche Modell können angezeigt und geändert werden.
• Es wird der Standarddienst von OpenAI unterstützt, und es ist auch möglich, mit kompatiblen lokalen oder entfernten Modellen zu verbinden.
• MIT ist open source und es fallen keine Butterfish-Abonnementsgebühren an; Quellcode und Verhalten sind überprüfbar.
• Die Unterbefehle prompt, gencmd und exec können unabhängig vom vollständigen Shell-Modus einzeln verwendet werden.

Einsatzbeschränkungen und Hinweise

• Offiziell wird derzeit hauptsächlich Bash und Zsh unter macOS und Linux unterstützt; es gibt keine native Unterstützung für Windows.
• Das Doppelpräfix-Modell für Agent und Action überspringt die Bestätigung; fehlerhafte Befehle können irreversible Schäden verursachen.
• Das Modell kann aufgrund einer fehlerhaften Version des Tools, des Betriebssystems oder des Pfads ungültige Befehle erzeugen.
• Die Geschichte und Ausgaben von Shell bilden den Kontext des Modells, wodurch ein Risiko von Datenlecks von vertraulichen und geschäftlichen Informationen besteht.
• Die automatische Vervollständigung bei häufigen API-Aufrufen kann zu unerwarteten Kosten für Tokens und Prioritäten führen.
• Der lokal kompatible Server muss eine streambasierte Responses-Schnittstelle bereitstellen; eine einfache Chat-Completions-Kompatibilität reicht dabei nicht aus.
• Die 0.x-Versionen können weiterhin Parameter, Standardmodelle, Interaktionen sowie die Formatierung der Anzeigen ändern.
• Butterfish ist kein System für Berechtigungsisolation, Backup, Auditing, Schutz vor Malware oder formelle Betriebsfreigabeverfahren.

API, GitHub und Open Source

Der vollständige Quellcode von Butterfish wird in einem öffentlichen GitHub-Repo gehostet, unterliegt der MIT-Lizenz und ist in Go geschrieben. Das Repo enthält einen Eingabepunkt für Befehle, eine Shell-Verpackung, Hilfetexte, Tests, Veröffentlichungskonfigurationen sowie Informationen zu den Abhängigkeiten. Entwickler können ihn gemäß der Lizenz prüfen, ändern und verbreiten.

Es handelt sich dabei nicht um ein SaaS-Produkt, das Remote-Business-APIs anbietet, sondern um einen Client für die OpenAI Responses API. Das Projekt ist auch nicht das Modell selbst – die MIT-Lizenz gilt nur für den Butterfish-Code, nicht für OpenAI, Drittanbietermodelle, Benutzerdaten oder andere Abhängigkeiten.

Grundlegende Informationen

Empfehlungswert

Die Empfehlungswertung liegt bei 4,3 von 5 Punkten. Butterfish integriert die Geschichte von Shell, klare Anzeigen sowie Einzelkommandos und mehrstufige Agenten in eine vertraute Terminalumgebung. Es handelt sich um ein Open-Source-Tool, das leicht ist und die Verbindung mit lokalen Modellen ermöglicht – daher besonders attraktiv für Nutzer, die viel mit der Kommandozeile arbeiten.

Die Abzüge resultieren hauptsächlich aus der automatischen Ausführung hochriskanter Aktionen, der Privatsphäre im Terminalkontext, den Kosten für die Nutzung von APIs sowie der begrenzten Unterstützung durch die Plattform. Es eignet sich eher als Hilfsfunktion für erfahrene Benutzer – anstatt es Menschen, die mit Shell nicht vertraut sind, zu ermöglichen, Modelleingaben ohne Überprüfung auszuführen.

Häufige Fragen

Ist Butterfish kostenlos?

Die Software selbst ist kostenlos und unterliegt der MIT-Lizenz; es gibt keine offiziellen Abonnementpakete. Bei der Verwendung von OpenAI oder anderen Cloud-Modellen müssen die entsprechenden API-Kosten selbst getragen werden.

Haben Butterfish und Fischschalen etwas miteinander zu tun?

Es besteht keine direkte Verbindung – Butterfish ist lediglich der Produktname. Offiziell werden derzeit nur bash und zsh getestet; man sollte nicht davon ausgehen, dass die Kompatibilität mit dem Fish-Shell gegeben ist, nur weil der Name „Fish“ enthält.

Wird Windows unterstützt?

Die offiziellen Installationsanleitungen nennen nur macOS und Linux – es wird keine Unterstützung für Windows angeboten. Ob WSL geeignet ist, hängt davon ab, ob man eigene Tests mit bestimmten Shell-Umgebungen, Terminals und Konfigurationen durchführen möchte.

Ist ein ChatGPT-Abo erforderlich?

Ein ChatGPT-Web-Abo ist nicht erforderlich, es wird jedoch standardmäßig ein eigenes OpenAI-API-Schlüssel sowie ein verfügbares Guthaben benötigt. Ein Web-Mitgliedschaft und API-Abrechnung sind unterschiedliche Produkte.

Welches Modell wird standardmäßig verwendet?

Die aktuelle Hauptversion von GitHub verwendet standardmäßig GPT-5.5 sowie eine hohe Berechnungskraft; im Schnellmodus wird der Priority-Service genutzt. Auf der alten Website finden sich noch Beispiele für GPT-4 Turbo – man sollte sich jedoch die Anleitung zur installierten Version ansehen.

Kann man lokale Modelle verwenden?

Es ist möglich, einen lokalen Server anzuschließen, der eine für OpenAI kompatible Responses-Stream-Schnittstelle bereitstellt. Dienste, die nur mit der herkömmlichen Chat-Schnittstelle kompatibel sind, funktionieren möglicherweise nicht, und die Qualität des Modells könnte unterhalb der des Modells liegen, das für die Standardanweisungen verwendet wird.

Wird die Shell-Geschichte in die Cloud gesendet?

Beim Senden einer AI-Anfrage sendet Butterfish die ausgewählten aktuellen Befehle, Ausgaben und Dialoge als Kontext an den konfigurierten Modell-Endpoint. Sensible Ausgaben sollten nicht in der zur Übertragung bereitgestellten Sitzung enthalten sein.

Ist Agent Mode sicher?

Im Modus mit einem Ausrufezeichen muss man die Befehle des Modells weiterhin sorgfältig überprüfen. Zwei Ausrufezeichen führen dazu, dass die Bestätigung übersprungen wird – das birgt ein sehr hohes Risiko. Es wird empfohlen, den sicheren Modus nur in isolierten Umgebungen sowie für vorübergehende Aufgaben mit Backups zu verwenden.

Was ist der Unterschied zwischen Action Mode und Agent Mode?

Im Action-Modus wird nur versucht, einen einzigen Shell-Befehl zu erzeugen und damit abzuschließen. Im Agent-Modus können mehrere Schritte ausgeführt werden, die Ergebnisse beobachtet und die Strategie angepasst werden. Bei einem einzelnen Präfix bleibt die Überprüfung standardmäßig aktiv, bei zwei Präfixen wird der Befehl automatisch ausgeführt.

Warum kann die automatische Vervollständigung teuer sein?

Es führt Vorhersagen des Modells durch, sobald der Benutzer eine Pause einlegt. Häufige Anfragen führen zu einer Anhäufung von Tokens sowie zu zusätzlichen Kosten für die Serviceebene. Man kann die automatische Vervollständigung deaktivieren, die Wartezeit verlängern oder ein günstigeres Modell wählen.

Kann ich die vollständigen Hinweise sehen?

Es ist möglich, die lokale YAML-Hilfedatenbank zu bearbeiten, und man kann im detaillierten Modus die ursprünglichen Anfragen sowie Antworten einsehen. Die detaillierten Protokolle können Geheimnisse enthalten; sie müssen nach der Verwendung sorgfältig gelöscht werden.

Ist Butterfish völlig offline?

Standardmäßig ist das nicht der Fall – es wird stattdessen die OpenAI-API verwendet. Die Interaktion mit dem Modell kann nur dann lokal oder im Intranet stattfinden, wenn ein lokales, kompatibles Modell konfiguriert wurde und alle Anfragen an die lokale Endpunkt-Adresse gerichtet sind.