Butterfish CLI Tools

Beschreibung

Butterfish ist eine Suite von Kommandozeilenwerkzeugen (CLI), die darauf ausgelegt ist, die Produktivität von Softwareentwicklern und Kommandozeilenbenutzern durch die direkte Integration von Large Language Models (LLMs) in ihren Workflow zu steigern. Das Kernangebot, Butterfish Shell, verwandelt Ihre bestehende Shell (bash, zsh) in einen KI-gestützten Assistenten. Indem Sie einen Befehl einfach mit einem Großbuchstaben beginnen, können Benutzer der KI kontextbezogene Fragen stellen und die Shell-Historie für relevante Unterstützung nutzen, ohne kopieren und einfügen zu müssen.

Dieses Werkzeug fungiert als "Shell-Wrapper", der Eingaben und Ausgaben abfängt, um KI-Funktionen bereitzustellen. Benutzer können nach Befehlen fragen, sich nach Befehlsfehlern erkundigen oder sogar den "Goal Mode" (eingeleitet mit '!') verwenden, bei dem die KI als Agent agiert, um Befehle auszuführen und ein bestimmtes Ziel zu erreichen, mit einem "Unsafe Goal Mode" (eingeleitet mit '!!') für die automatisierte Ausführung. Butterfish Shell bietet Funktionen wie die Befehlsautovervollständigung, ähnlich wie GitHub Copilot, und pflegt den Gesprächsverlauf, was eine iterative Verfeinerung von KI-generierten Befehlen oder Antworten ermöglicht.

Über die Shell-Integration hinaus enthält Butterfish weitere Dienstprogramme wie einen direkten Prompt-Client, einen Befehlsgenerator, einen Dateizusammenfasser und Werkzeuge zur Verwaltung von Embeddings lokaler Dateien. Das Projekt legt Wert auf Transparenz und ermöglicht es Benutzern, die an die KI gesendeten Prompts über Konfigurationsdateien einzusehen und anzupassen. Es unterstützt OpenAI-kompatible APIs, was die Verwendung lokaler oder alternativer LLM-Anbieter ermöglicht. Butterfish ist Open Source, unter der MIT-Lizenz lizenziert und freut sich über Beiträge aus der Community.

Die Zielgruppe umfasst Entwickler, Systemadministratoren und alle, die häufig von der Kommandozeile aus arbeiten und KI nutzen möchten, um Aufgaben schneller zu erledigen, Fehler zu beheben und Code zu generieren. Das Wertversprechen liegt in der nahtlosen Integration in bestehende Workflows, der Reduzierung von Kontextwechseln und der Bereitstellung von KI-Unterstützung mit hohem Kontext genau dann und dort, wo sie benötigt wird.

Butterfish CLI Tools's Kernfunktionen

• KI-gestützte Shell-Integration für bash und zsh

• Kontextbezogenes KI-Prompting unter Verwendung der Shell-Historie

• Befehlsautovervollständigung im GitHub Copilot-Stil

• Goal Mode für KI-gesteuerte Befehlsausführung

• Unsafe Goal Mode für automatisierte Befehlsausführung

• Anpassbare KI-Prompts und Systemnachrichten

• Unterstützung für OpenAI-kompatible APIs und lokale Modelle

• Dateizusammenfassung und Text-Embedding-Funktionen

• Transparente Protokollierung von KI-Anfragen und -Antworten

• Open Source unter der MIT-Lizenz

Wie verwendet man Butterfish CLI Tools?

1. 1

   Installation: Verwenden Sie Homebrew unter macOS (`brew install bakks/bakks/butterfish`) oder `go install`.

2. 2

   Authentifizierung: Führen Sie `butterfish shell` aus und fügen Sie Ihren OpenAI API Secret Key ein, wenn Sie dazu aufgefordert werden.

3. 3

   Konfiguration: Optional können Sie `butterfish` in Ihrer Shell-rc-Datei in `bf` umbenennen, um die Verwendung zu erleichtern.

4. 4

   Shell-Modus verwenden: Beginnen Sie Befehle mit einem Großbuchstaben für KI-Prompts oder mit '!' für den Goal Mode.

5. 5

   Autosuggest: Drücken Sie Tab, um KI-generierte Befehlsvervollständigungen zu akzeptieren.

6. 6

   Debuggen: Stellen Sie kontextbezogene Fragen wie 'Warum ist dieser Befehl fehlgeschlagen?'

7. 7

   Zusammenfassen: Verwenden Sie `butterfish summarize <Dateien>`, um semantische Zusammenfassungen von Dateien zu erhalten.

Butterfish CLI Tools's Anwendungsfälle

• KI-Shell-Assistent
• Befehlsgenerierung
• Dateizusammenfassung
• Code-Debugging
• Kontextbezogenes Prompting
• Agentenbasierte Aufgabenausführung
• Lokale LLM-Integration
• Verwaltung von Text-Embeddings

FAQ von Butterfish CLI Tools

• Was ist Butterfish und was macht es?

  Butterfish ist eine Sammlung von CLI-Tools, die KI-Prompting in Ihren Kommandozeilen-Workflow integrieren und Funktionen wie KI-gestützte Shell-Befehle, Autovervollständigung und zielorientierte Aufgabenausführung bieten.

• Wie verleiht Butterfish Shell meinem Terminal KI-Superkräfte?

  Butterfish Shell umschließt Ihre bestehende Shell (bash, zsh) und ermöglicht es Ihnen, die KI durch Starten von Befehlen mit einem Großbuchstaben anzusprechen. Es verwendet Ihre Shell-Historie, um kontextbezogene KI-Unterstützung zu bieten.

• Kann Butterfish mir beim Debuggen von Befehlen helfen?

  Ja, Sie können kontextbezogene Fragen stellen wie 'Warum ist dieser Befehl fehlgeschlagen?', nachdem ein Befehl ausgeführt wurde, und Butterfish wird die KI verwenden, um das Problem zu diagnostizieren.

• Was ist der Goal Mode in Butterfish?

  Der Goal Mode, eingeleitet mit '!', ermöglicht es der KI, als Agent zu agieren. Sie geben ein Ziel vor, und die KI schlägt Befehle vor und führt diese aus, um es zu erreichen, wobei sie Ihre Shell-Historie als Kontext nutzt.

• Wie installiere ich Butterfish?

  Butterfish kann unter macOS und Linux installiert werden. Unter macOS können Sie Homebrew (`brew install bakks/bakks/butterfish`) verwenden. Alternativ können Sie `go install` verwenden.

• Benötigt Butterfish einen OpenAI API Key?

  Ja, Butterfish verwendet standardmäßig OpenAI APIs. Sie müssen Ihren OpenAI API Secret Key bei der ersten Ausführung von `butterfish shell` angeben.

• Kann ich Butterfish mit lokalen LLMs oder anderen API-Anbietern verwenden?

  Ja, Butterfish unterstützt OpenAI-kompatible APIs. Sie können das Flag `--base-url` verwenden, um auf ein lokales Modell oder einen anderen kompatiblen API-Endpunkt zu verweisen.

• Ist Butterfish Open Source?

  Ja, Butterfish ist ein Open-Source-Projekt, das unter der MIT-Lizenz lizenziert ist.

• Welche anderen Dienstprogramme bietet Butterfish neben dem Shell-Wrapper?

  Butterfish enthält auch Dienstprogramme für direktes LLM-Prompting, das Generieren von Shell-Befehlen, das semantische Zusammenfassen von Dateien und die Verwaltung von Embeddings lokaler Dateien.

• Wie geht Butterfish mit langen Befehlsausgaben oder -historien um?

  Butterfish verwaltet die Historie innerhalb der Token-Limits für API-Anfragen. Lange Befehlsausgaben werden auf ein konfigurierbares Token-Limit gekürzt, und ältere Verlaufsdaten können außerhalb des Kontextfensters fallen.

• Kann ich die an die KI gesendeten Prompts anpassen?

  Ja, Butterfish macht Prompts transparent und konfigurierbar. Sie können die Prompt-Wrapper in `~/.config/butterfish/prompts.yaml` bearbeiten.

• Was ist der 'Unsafe Goal Mode'?

  Der Unsafe Goal Mode, eingeleitet mit '!!', ermöglicht es der KI, Befehle ohne Bestätigung auszuführen. Dieser Modus ist potenziell gefährlich und sollte mit Vorsicht verwendet werden.