CLI

HanuBees CLI Optionen und Befehle.

Der HanuBees CLI startet standardmäßig das TUI, wenn er ohne Argumente ausgeführt wird.

HanuBees

Es akzeptiert aber auch Befehle, wie auf dieser Seite dokumentiert. Dadurch können Sie programmgesteuert mit HanuBees interagieren.

HanuBees run "Explain how closures work in JavaScript"

tui

Starten Sie die Terminalbenutzeroberfläche HanuBees.

HanuBees [project]

Optionen

Flag	Kurz	Beschreibung
`--continue`	`-c`	Setzen Sie die letzte Sitzung fort
`--session`	`-s`	Session-ID zum Fortfahren
`--fork`		Sitzung beim Fortsetzen verzweigen (mit `--continue` oder `--session`)
`--prompt`		Prompt zur Verwendung
`--model`	`-m`	Zu verwendendes Modell in der Form provider/model
`--agent`		Zu verwendender Agent
`--port`		Port zum Abhören
`--hostname`		Hostname zum Abhören

Befehle

Der HanuBees CLI verfügt außerdem über die folgenden Befehle.

agent

Agenten für HanuBees verwalten.

HanuBees agent [command]

attach

Schließen Sie ein Terminal an einen bereits laufenden HanuBees-Backend-Server an, der über die Befehle serve oder web gestartet wurde.

HanuBees attach [url]

Dies ermöglicht die Verwendung von TUI mit einem Remote-Backend HanuBees. Zum Beispiel:

# Start the backend server for web/mobile access
HanuBees web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
HanuBees attach http://10.20.30.40:4096

Optionen

Flag	Kurz	Beschreibung
`--dir`		Arbeitsverzeichnis zum Starten von TUI in
`--continue`	`-c`	Letzte Sitzung fortsetzen
`--session`	`-s`	Session-ID zum Fortfahren
`--fork`		Sitzung beim Fortsetzen abzweigen (mit `--continue` oder `--session` verwenden)
`--password`	`-p`	Basic-Auth-Passwort (standardmäßig `HanuBees_SERVER_PASSWORD`)
`--username`	`-u`	Basic-Auth-Benutzername (standardmäßig `HanuBees_SERVER_USERNAME` oder `HanuBees`)

create

Erstellen Sie einen neuen Agenten mit benutzerdefinierter Konfiguration.

HanuBees agent create

Dieser Befehl führt Sie durch die Erstellung eines neuen Agenten mit einer benutzerdefinierten Systemeingabeaufforderung und Toolkonfiguration.

list

Listen Sie alle verfügbaren Agenten auf.

HanuBees agent list

auth

Befehl zum Verwalten von Anmeldeinformationen und Anmelden für Anbieter.

HanuBees auth [command]

HanuBees wird von der Anbieterliste bei Models.dev unterstützt, sodass Sie HanuBees auth login verwenden können, um API-Schlüssel für jeden Anbieter zu konfigurieren, den Sie verwenden möchten. Dies wird in ~/.local/share/HanuBees/auth.json gespeichert.

HanuBees auth login

Wenn HanuBees startet, lädt es den Anbieter aus der Anmeldeinformationsdatei. Und ob in Ihren Umgebungen Schlüssel sind oder in Ihrem Projekt eine .env-Datei vorhanden ist.

list

Listet alle authentifizierten Anbieter auf, wie in der Anmeldeinformationsdatei gespeichert.

HanuBees auth list

Oder die Kurzversion.

HanuBees auth ls

logout

Melden Sie sich von einem Anbieter ab, indem Sie ihn aus der Anmeldeinformationsdatei löschen.

HanuBees auth logout

github

Verwalten Sie den GitHub-Agenten für die Repository-Automatisierung.

HanuBees github [command]

install

Installieren Sie den GitHub-Agenten in Ihrem Repository.

HanuBees github install

Dadurch wird der erforderliche GitHub-Aktionsworkflow eingerichtet und Sie durch den Konfigurationsprozess geführt. Learn more.

run

Führen Sie den GitHub-Agenten aus. Dies wird normalerweise in GitHub-Aktionen verwendet.

HanuBees github run

Optionen

Flag	Beschreibung
`--event`	GitHub Scheinereignis zum Ausführen des Agenten für
`--token`	GitHub persönliches Zugriffstoken

mcp

Verwalten Sie Model Context Protocol-Server.

HanuBees mcp [command]

add

Fügen Sie Ihrer Konfiguration einen MCP-Server hinzu.

HanuBees mcp add

Dieser Befehl führt Sie durch das Hinzufügen eines lokalen oder Remote-MCP-Servers.

list

Listen Sie alle konfigurierten MCP-Server und deren Verbindungsstatus auf.

HanuBees mcp list

Oder nutzen Sie die Kurzversion.

HanuBees mcp ls

auth

Authentifizieren Sie sich mit einem OAuth-fähigen MCP-Server.

HanuBees mcp auth [name]

Wenn Sie keinen Servernamen angeben, werden Sie aufgefordert, einen der verfügbaren OAuth-fähigen Server auszuwählen.

Sie können auch OAuth-fähige Server und deren Authentifizierungsstatus auflisten.

HanuBees mcp auth list

Oder nutzen Sie die Kurzversion.

HanuBees mcp auth ls

logout

Entfernen Sie OAuth-Anmeldeinformationen für einen MCP-Server.

HanuBees mcp logout [name]

debug

Beheben Sie OAuth-Verbindungsprobleme für einen MCP-Server.

HanuBees mcp debug <name>

models

Listen Sie alle verfügbaren Modelle der konfigurierten Anbieter auf.

HanuBees models [provider]

Dieser Befehl zeigt alle bei Ihren konfigurierten Anbietern verfügbaren Modelle im Format provider/model an.

Dies ist nützlich, um die genauen Modellnamen herauszufinden, die in Ihrer Konfiguration verwendet werden sollen.

Sie können optional eine Anbieter-ID übergeben, um Modelle nach diesem Anbieter zu filtern.

HanuBees models anthropic

Optionen

Flag	Beschreibung
`--refresh`	Aktualisieren Sie den Modellcache von models.dev
`--verbose`	Verwenden Sie eine ausführlichere Modellausgabe (einschließlich Metadaten wie Kosten)

Verwenden Sie das Flag --refresh, um die zwischengespeicherte Modellliste zu aktualisieren. Dies ist nützlich, wenn einem Anbieter neue Modelle hinzugefügt wurden und Sie diese in HanuBees sehen möchten.

HanuBees models --refresh

run

Führen Sie HanuBees im nicht interaktiven Modus aus, indem Sie direkt eine Eingabeaufforderung übergeben.

HanuBees run [message..]

Dies ist nützlich für die Skripterstellung, die Automatisierung oder wenn Sie eine schnelle Antwort wünschen, ohne das vollständige TUI zu starten. Zum Beispiel:

HanuBees run Explain the use of context in Go

Sie können auch eine Verbindung zu einer laufenden HanuBees serve-Instanz herstellen, um bei jedem Lauf Kaltstartzeiten für den MCP-Server zu vermeiden:

# Start a headless server in one terminal
HanuBees serve

# In another terminal, run commands that attach to it
HanuBees run --attach http://localhost:4096 "Explain async/await in JavaScript"

Optionen

Flag	Kurz	Beschreibung
`--command`		Der auszuführende Befehl, Argumente als Nachricht verwenden
`--continue`	`-c`	Setzen Sie die letzte Sitzung fort
`--session`	`-s`	Session-ID zum Fortfahren
`--fork`		Sitzung beim Fortsetzen verzweigen (mit `--continue` oder `--session` verwenden)
`--share`		Teilen Sie die Sitzung
`--model`	`-m`	Zu verwendendes Modell in der Form provider/model
`--agent`		Zu verwendender Agent
`--file`	`-f`	Datei(en) zum Anhängen an die Nachricht
`--format`		Format: default (formatiert) oder json (rohe JSON-Ereignisse)
`--title`		Titel für die Sitzung (verwendet eine verkürzte Eingabeaufforderung, wenn kein Wert angegeben wird)
`--attach`		An einen laufenden HanuBees-Server anschließen (z.B. http://localhost:4096)
`--password`	`-p`	Basic-Auth-Passwort (standardmäßig `HanuBees_SERVER_PASSWORD`)
`--username`	`-u`	Basic-Auth-Benutzername (standardmäßig `HanuBees_SERVER_USERNAME` oder `HanuBees`)
`--dir`		Verzeichnis für die Ausführung, oder Pfad auf dem Remote-Server beim Anhängen
`--variant`		Modellvariante (anbieterspezifischer Reasoning-Aufwand)
`--thinking`		Denkblöcke anzeigen
`--port`		Port für den lokalen Server (standardmäßig zufälliger Port)

serve

Starten Sie einen Headless-HanuBees-Server für den API-Zugriff. Sehen Sie sich die Server-Dokumentation für die vollständige HTTP-Schnittstelle an.

HanuBees serve

Dadurch wird ein HTTP-Server gestartet, der API-Zugriff auf HanuBees-Funktionalität ohne die TUI-Schnittstelle bietet. Legen Sie HanuBees_SERVER_PASSWORD fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig HanuBees).

Optionen

Flag	Beschreibung
`--port`	Port zum Abhören
`--hostname`	Hostname zum Abhören
`--mdns`	mDNS-Discovery aktivieren
`--cors`	Zusätzliche Browser-Ursprünge für CORS zulassen

session

HanuBees-Sitzungen verwalten.

HanuBees session [command]

list

Listen Sie alle HanuBees-Sitzungen auf.

HanuBees session list

Optionen

Flag	Kurz	Beschreibung
`--max-count`	`-n`	Beschränken auf die N neuesten Sitzungen
`--format`		Ausgabeformat: table oder json (table)

stats

Zeigen Sie Token-Nutzungs- und Kostenstatistiken für Ihre HanuBees-Sitzungen an.

HanuBees stats

Optionen

Flag	Beschreibung
`--days`	Statistiken für die letzten N Tage anzeigen (alle Zeiten)
`--tools`	Anzahl der angebotenen Werkzeuge (alle)
`--models`	Aufschlüsselung der Modellnutzung anzeigen (standardmäßig ausgeblendet). Übergeben Sie eine Zahl, um die obersten N anzuzeigen
`--project`	Nach Projekt filtern (alle Projekte, leere Zeichenfolge: aktuelles Projekt)

export

Sitzungsdaten als JSON exportieren.

HanuBees export [sessionID]

Wenn Sie keine Sitzungs-ID angeben, werden Sie aufgefordert, eine der verfügbaren Sitzungen auszuwählen.

import

Importieren Sie Sitzungsdaten aus einer JSON-Datei oder einer HanuBees-Freigabe-URL.

HanuBees import <file>

Sie können aus einer lokalen Datei oder einer HanuBees-Freigabe-URL importieren.

HanuBees import session.json
HanuBees import https://opncd.ai/s/abc123

web

Starten Sie einen Headless-HanuBees-Server mit einer Weboberfläche.

HanuBees web

Dadurch wird ein HTTP-Server gestartet und ein Webbrowser geöffnet, um über eine Webschnittstelle auf HanuBees zuzugreifen. Legen Sie HanuBees_SERVER_PASSWORD fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig HanuBees).

Optionen

Flag	Beschreibung
`--port`	Port zum Abhören
`--hostname`	Hostname zum Abhören
`--mdns`	mDNS-Discovery aktivieren
`--cors`	Zusätzliche Browser-Ursprünge für CORS zulassen

acp

Starten Sie einen ACP (Agent Client Protocol) Server.

HanuBees acp

Dieser Befehl startet einen ACP-Server, der über stdin/stdout unter Verwendung von nd-JSON kommuniziert.

Optionen

Flag	Beschreibung
`--cwd`	Arbeitsverzeichnis
`--port`	Port zum Abhören
`--hostname`	Hostname zum Abhören

uninstall

Deinstallieren Sie HanuBees und entfernen Sie alle zugehörigen Dateien.

HanuBees uninstall

Optionen

Flag	Kurz	Beschreibung
`--keep-config`	`-c`	Konfigurationsdateien behalten
`--keep-data`	`-d`	Sitzungsdaten und Snapshots aufbewahren
`--dry-run`		Zeigt, was entfernt werden würde, ohne zu entfernen
`--force`	`-f`	Bestätigungsaufforderungen überspringen

upgrade

Aktualisiert HanuBees auf die neueste Version oder eine bestimmte Version.

HanuBees upgrade [target]

Um auf die neueste Version zu aktualisieren:

HanuBees upgrade

Um auf eine bestimmte Version zu aktualisieren.

HanuBees upgrade v0.1.48

Optionen

Flag	Kurz	Beschreibung
`--method`	`-m`	Die zu verwendende Installationsmethode; curl, npm, pnpm, bun, brew

Globale Flags

Der HanuBees CLI akzeptiert die folgenden globalen Flags.

Flag	Kurz	Beschreibung
`--help`	`-h`	Hilfe anzeigen
`--version`	`-v`	Versionsnummer drucken
`--print-logs`		Protokolle nach stderr drucken
`--log-level`		Protokollebene (DEBUG, INFO, WARN, ERROR)

Umgebungsvariablen

HanuBees kann mithilfe von Umgebungsvariablen konfiguriert werden.

Variable	Typ	Beschreibung
`HanuBees_AUTO_SHARE`	boolescher Wert	Sitzungen automatisch teilen
`HanuBees_GIT_BASH_PATH`	Zeichenfolge	Pfad zur ausführbaren Git Bash-Datei unter Windows
`HanuBees_CONFIG`	Zeichenfolge	Pfad zur Konfigurationsdatei
`HanuBees_CONFIG_DIR`	Zeichenfolge	Pfad zum Konfigurationsverzeichnis
`HanuBees_CONFIG_CONTENT`	Zeichenfolge	Inline-JSON-Konfigurationsinhalt
`HanuBees_DISABLE_AUTOUPDATE`	boolescher Wert	Automatische Update-Prüfungen deaktivieren
`HanuBees_DISABLE_PRUNE`	boolescher Wert	Bereinigung alter Daten deaktivieren
`HanuBees_DISABLE_TERMINAL_TITLE`	boolescher Wert	Deaktivieren Sie die automatische Aktualisierung von Terminaltiteln
`HanuBees_PERMISSION`	Zeichenfolge	Inline-JSON-Berechtigungskonfiguration
`HanuBees_DISABLE_DEFAULT_PLUGINS`	boolescher Wert	Standard-Plugins deaktivieren
`HanuBees_DISABLE_LSP_DOWNLOAD`	boolescher Wert	Automatische LSP-Server-Downloads deaktivieren
`HanuBees_ENABLE_EXPERIMENTAL_MODELS`	boolescher Wert	Experimentelle Modelle aktivieren
`HanuBees_DISABLE_AUTOCOMPACT`	boolescher Wert	Automatische Kontextkomprimierung deaktivieren
`HanuBees_DISABLE_CLAUDE_CODE`	boolescher Wert	Deaktivieren Sie das Lesen von `.claude` (Prompt + Skills)
`HanuBees_DISABLE_CLAUDE_CODE_PROMPT`	boolescher Wert	Deaktivieren Sie das Lesen von `~/.claude/CLAUDE.md`
`HanuBees_DISABLE_CLAUDE_CODE_SKILLS`	boolescher Wert	Deaktivieren Sie das Laden von `.claude/skills`
`HanuBees_DISABLE_MODELS_FETCH`	boolescher Wert	Deaktivieren Sie das Abrufen von Modellen aus Remote-Quellen
`HanuBees_FAKE_VCS`	Zeichenfolge	Gefälschter VCS-Anbieter zu Testzwecken
`HanuBees_CLIENT`	Zeichenfolge	Client-ID (standardmäßig `cli`)
`HanuBees_ENABLE_EXA`	boolescher Wert	Exa-Websuchtools aktivieren
`HanuBees_SERVER_PASSWORD`	Zeichenfolge	Aktivieren Sie die Basisauthentifizierung für `serve`/`web`
`HanuBees_SERVER_USERNAME`	Zeichenfolge	Benutzernamen für die Basisauthentifizierung überschreiben (Standard `HanuBees`)
`HanuBees_MODELS_URL`	Zeichenfolge	Benutzerdefinierte URL zum Abrufen der Modellkonfiguration

Experimentell

Diese Umgebungsvariablen ermöglichen experimentelle Funktionen, die sich ändern oder entfernt werden können.

Variable	Typ	Beschreibung
`HanuBees_EXPERIMENTAL`	boolescher Wert	Experimentelle Funktionen unter dem Sammelflag aktivieren
`HanuBees_EXPERIMENTAL_ICON_DISCOVERY`	boolescher Wert	Symbolerkennung aktivieren
`HanuBees_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolescher Wert	Kopieren bei Auswahl in TUI deaktivieren
`HanuBees_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	Zahl	Standard-Timeout für Bash-Befehle in ms
`HanuBees_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	Zahl	Maximale Ausgabetokens für LLM-Antworten
`HanuBees_EXPERIMENTAL_FILEWATCHER`	boolescher Wert	Dateiüberwachung für das gesamte Verzeichnis aktivieren
`HanuBees_EXPERIMENTAL_OXFMT`	boolescher Wert	Oxfmt-Formatierer aktivieren
`HanuBees_EXPERIMENTAL_LSP_TOOL`	boolescher Wert	Experimentelles LSP-Tool aktivieren
`HanuBees_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolescher Wert	Dateiüberwachung deaktivieren
`HanuBees_EXPERIMENTAL_EXA`	boolescher Wert	Experimentelle Exa-Funktionen aktivieren
`HanuBees_EXPERIMENTAL_LSP_TY`	boolescher Wert	TY LSP für Python-Dateien aktivieren
`HanuBees_EXPERIMENTAL_PLAN_MODE`	boolescher Wert	Planmodus aktivieren
`HanuBees_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	boolescher Wert	Hintergrundaufgaben für Subagenten aktivieren
`HanuBees_EXPERIMENTAL_EVENT_SYSTEM`	boolescher Wert	Experimentelles Ereignissystem aktivieren
`HanuBees_EXPERIMENTAL_NATIVE_LLM`	boolescher Wert	Nativen LLM-Anfragepfad aktivieren
`HanuBees_EXPERIMENTAL_PARALLEL`	boolescher Wert	Parallele Websuche aktivieren
`HanuBees_EXPERIMENTAL_SCOUT`	boolescher Wert	Scout-Subagent aktivieren
`HanuBees_EXPERIMENTAL_WORKSPACES`	boolescher Wert	Workspace-Unterstützung aktivieren