CLI

Opcje i polecenia wiersza poleceń HanuBees.

CLI HanuBees domyślnie uruchamia TUI, gdy wywołasz je bez argumentów.

HanuBees

CLI obsługuje też polecenia opisane na tej stronie, więc możesz używać HanuBees programowo.

HanuBees run "Explain how closures work in JavaScript"

tui

Uruchamia interfejs terminalowy (TUI) HanuBees.

HanuBees [project]

Flagi

Flaga	Skrót	Opis
`--continue`	`-c`	Kontynuuj ostatnią sesję
`--session`	`-s`	Identyfikator sesji do kontynuowania
`--fork`		Sklonuj sesję podczas kontynuacji (użyj z `--continue` lub `--session`)
`--prompt`		Monit do użycia
`--model`	`-m`	Model do użycia w formacie dostawca/model
`--agent`		Agent do użycia
`--port`		Port do nasłuchiwania
`--hostname`		Nazwa hosta, do której należy się powiązać

Polecenia

Interfejs CLI HanuBees zawiera także dodatkowe polecenia.

agent

Zarządzaj agentami HanuBees.

HanuBees agent [command]

attach

Dołącz terminal do już działającego serwera backendu HanuBees uruchomionego za pomocą serve lub web.

HanuBees attach [url]

Pozwala to połączyć TUI ze zdalnym backendem HanuBees. Na przykład:

# 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

Flagi

Flaga	Skrót	Opis
`--dir`		Katalog roboczy, w którym uruchomić TUI
`--continue`	`-c`	Kontynuuj ostatnią sesję
`--session`	`-s`	Identyfikator sesji do kontynuowania
`--fork`		Rozgałęź sesję podczas kontynuowania (użyj z `--continue` lub `--session`)
`--password`	`-p`	Hasło uwierzytelniania podstawowego (domyślnie `HanuBees_SERVER_PASSWORD`)
`--username`	`-u`	Nazwa użytkownika uwierzytelniania podstawowego (domyślnie `HanuBees_SERVER_USERNAME` lub `HanuBees`)

create

Utwórz nowego agenta z niestandardową konfiguracją.

HanuBees agent create

To polecenie poprowadzi Cię przez proces tworzenia nowego agenta z niestandardowym promptem systemowym i konfiguracją narzędzi.

list

Wyświetl listę wszystkich agentów.

HanuBees agent list

auth

Zarządzaj danymi uwierzytelniającymi i logowaniem dla dostawców.

HanuBees auth [command]

HanuBees integruje się z wieloma dostawcami. Możesz użyć HanuBees auth login, aby skonfigurować klucz API dla dowolnego obsługiwanego dostawcy. Klucze są bezpiecznie przechowywane w ~/.local/share/HanuBees/auth.json.

HanuBees auth login

Podczas uruchamiania HanuBees ładuje dostawców z pliku poświadczeń, a także ze zmiennych środowiskowych lub pliku .env w Twoim projekcie.

list

Wyświetl listę wszystkich uwierzytelnionych dostawców przechowywanych w pliku poświadczeń.

HanuBees auth list

Lub skrócona wersja:

HanuBees auth ls

logout

Wyloguj się z dostawcy, usuwając go z pliku poświadczeń.

HanuBees auth logout

github

Zarządzaj agentem GitHub w celu automatyzacji repozytorium.

HanuBees github [command]

install

Zainstaluj agenta GitHub w swoim repozytorium.

HanuBees github install

Spowoduje to utworzenie pliku workflow GitHub Actions i poprowadzi Cię przez proces konfiguracji. Dowiedz się więcej.

run

Uruchom agenta na GitHubie. Zwykle używane w GitHub Actions.

HanuBees github run

Flagi

Flaga	Opis
`--event`	Zdarzenie GitHub, które wyzwoliło agenta
`--token`	Osobisty token dostępu GitHub

mcp

Zarządzaj serwerami Model Context Protocol (MCP).

HanuBees mcp [command]

add

Dodaj serwer MCP do swojej konfiguracji.

HanuBees mcp add

To polecenie poprowadzi Cię przez proces dodawania lokalnego lub zdalnego serwera MCP.

list

Wyświetl listę wszystkich skonfigurowanych serwerów MCP i ich status.

HanuBees mcp list

Lub skrócona wersja:

HanuBees mcp ls

auth

Uwierzytelnij się w serwerze MCP z włączoną funkcją OAuth.

HanuBees mcp auth [name]

Jeśli nie podasz nazwy serwera, zostaniesz poproszony o wybranie jednego z serwerów wymagających uwierzytelnienia.

Możesz także wyświetlić listę serwerów obsługujących OAuth i ich status uwierzytelnienia.

HanuBees mcp auth list

Lub skrócona wersja:

HanuBees mcp auth ls

logout

Usuń tokeny OAuth dla serwera MCP.

HanuBees mcp logout [name]

debug

Debuguj problemy z połączeniem OAuth dla serwera MCP.

HanuBees mcp debug <name>

models

Wyświetl listę modeli ze wszystkich skonfigurowanych dostawców.

HanuBees models [provider]

Pokazuje modele dostępne do użycia w provider/model.

Jest to identyfikator modelu, którego używasz w konfiguracji.

Opcjonalnie możesz podać identyfikator dostawcy, aby filtrować modele według tego dostawcy.

HanuBees models anthropic

Flagi

Flaga	Opis
`--refresh`	Odśwież pamięć podręczną modeli
`--verbose`	Bardziej szczegółowe dane wyjściowe modelu (zawiera metadane, takie jak koszty)

Użyj flagi --refresh, aby zaktualizować listę modeli w pamięci podręcznej. Jest to przydatne, gdy dostawca dodał nowe modele, które chcesz zobaczyć w HanuBees.

HanuBees models --refresh

run

Uruchom HanuBees w trybie nieinteraktywnym, przekazując bezpośrednio prompt.

HanuBees run [message..]

Jest to przydatne do tworzenia skryptów, automatyzacji lub gdy chcesz wysłać szybkie zapytanie bez uruchamiania TUI. Na przykład:

HanuBees run Explain the use of context in Go

Można również użyć tego z działającym HanuBees serve, aby uniknąć zimnego startu serwera MCP przy każdym uruchomieniu:

# 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"

Flagi

Flaga	Skrót	Opis
`--command`		Polecenie do uruchomienia, reszta to argumenty
`--continue`	`-c`	Kontynuuj ostatnią sesję
`--session`	`-s`	Identyfikator sesji do kontynuowania
`--fork`		Sklonuj sesję podczas kontynuacji (użyj z `--continue` lub `--session`)
`--share`		Udostępnij sesję po zakończeniu
`--model`	`-m`	Model do użycia w formacie dostawca/model
`--agent`		Agent do użycia
`--file`	`-f`	Pliki do załączenia do wiadomości
`--format`		Format wyjściowy: `default` (sformatowany) lub `json` (surowy JSON)
`--title`		Tytuł sesji (jeśli nie podano, zostanie wygenerowany z promptu)
`--attach`		Dołącz do działającego serwera HanuBees (np. http://localhost:4096)
`--password`	`-p`	Hasło uwierzytelniania podstawowego (domyślnie `HanuBees_SERVER_PASSWORD`)
`--username`	`-u`	Nazwa użytkownika uwierzytelniania podstawowego (domyślnie `HanuBees_SERVER_USERNAME` lub `HanuBees`)
`--dir`		Katalog do uruchomienia lub ścieżka na zdalnym serwerze podczas dołączania
`--variant`		Wariant modelu (poziom wnioskowania specyficzny dla dostawcy)
`--thinking`		Pokaż bloki myślenia
`--port`		Port dla serwera lokalnego (domyślnie losowy)

serve

Uruchom serwer HanuBees (bez interfejsu) w celu uzyskania dostępu do API. Pełny opis API HTTP znajduje się w dokumentacji serwera.

HanuBees serve

Uruchamia to serwer HTTP, który zapewnia dostęp do API HanuBees bez interfejsu TUI. Ustaw HanuBees_SERVER_PASSWORD, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika to HanuBees).

Flagi

Flaga	Opis
`--port`	Port do nasłuchiwania
`--hostname`	Nazwa hosta, do której należy się powiązać
`--mdns`	Włącz wykrywanie mDNS
`--cors`	Dodatkowe dozwolone źródła CORS

session

Zarządzaj sesjami HanuBees.

HanuBees session [command]

list

Lista wszystkich sesji HanuBees.

HanuBees session list

Flagi

Flaga	Skrót	Opis
`--max-count`	`-n`	Ogranicz do ostatnich N sesji
`--format`		Format wyjściowy: tabela lub json (tabela)

stats

Pokaż statystyki wykorzystania tokenów i sesji HanuBees.

HanuBees stats

Flagi

Flaga	Opis
`--days`	Pokaż statystyki z ostatnich N dni (domyślnie: cały czas)
`--tools`	Pokaż użycie poszczególnych narzędzi (domyślnie: wszystkie)
`--models`	Pokaż podział na modele (domyślnie ukryty). Podaj liczbę, aby pokazać N najczęstszych
`--project`	Filtruj według projektu (domyślnie: wszystkie projekty, pusty ciąg: bieżący projekt)

export

Eksportuj dane sesji jako JSON.

HanuBees export [sessionID]

Jeśli nie podasz identyfikatora sesji, zostaniesz poproszony o wybranie jednej z ostatnich sesji.

import

Importuj dane sesji z pliku JSON lub adresu URL udostępniania HanuBees.

HanuBees import <file>

Możesz importować z pliku lokalnego lub adresu URL.

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

web

Uruchom serwer HanuBees z interfejsem internetowym.

HanuBees web

Uruchamia to serwer HTTP i udostępnia HanuBees przez interfejs przeglądarkowy. Ustaw HanuBees_SERVER_PASSWORD, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika to HanuBees).

Flagi

Flaga	Opis
`--port`	Port do nasłuchiwania
`--hostname`	Nazwa hosta, do której należy się powiązać
`--mdns`	Włącz wykrywanie mDNS
`--cors`	Dodatkowe dozwolone źródła CORS

acp

Uruchom serwer ACP (Agent Client Protocol).

HanuBees acp

Uruchamia serwer ACP, który komunikuje się przez stdin/stdout przy użyciu JSON-RPC.

Flagi

Flaga	Opis
`--cwd`	Katalog roboczy
`--port`	Port do nasłuchiwania
`--hostname`	Nazwa hosta, do której należy się powiązać

uninstall

Odinstaluj HanuBees i usuń wszystkie powiązane pliki.

HanuBees uninstall

Flagi

Flaga	Skrót	Opis
`--keep-config`	`-c`	Zachowaj pliki konfiguracyjne
`--keep-data`	`-d`	Zachowaj dane sesji i migawki
`--dry-run`		Pokaż co zostanie usunięte
`--force`	`-f`	Pomiń monity o potwierdzenie

upgrade

Aktualizuj HanuBees do najnowszej lub określonej wersji.

HanuBees upgrade [target]

Aby zaktualizować do najnowszej wersji:

HanuBees upgrade

Aby zaktualizować do konkretnej wersji:

HanuBees upgrade v0.1.48

Flagi

Flaga	Skrót	Opis
`--method`	`-m`	Wymuś metodę instalacji: curl, npm, pnpm, bun, brew

Flagi globalne

Interfejs CLI HanuBees przyjmuje następujące flagi globalne dla każdego polecenia.

Flaga	Skrót	Opis
`--help`	`-h`	Wyświetl pomoc
`--version`	`-v`	Wydrukuj numer wersji
`--print-logs`		Drukuj logi na stderr
`--log-level`		Poziom logowania (DEBUG, INFO, WARN, ERROR)

Zmienne środowiskowe

HanuBees można skonfigurować za pomocą zmiennych środowiskowych.

Zmienna	Typ	Opis
`HanuBees_AUTO_SHARE`	boolean	Automatycznie udostępniaj sesje
`HanuBees_GIT_BASH_PATH`	string	Ścieżka do pliku wykonywalnego Git Bash w systemie Windows
`HanuBees_CONFIG`	string	Ścieżka do pliku konfiguracyjnego
`HanuBees_TUI_CONFIG`	string	Ścieżka do pliku konfiguracyjnego TUI
`HanuBees_CONFIG_DIR`	string	Ścieżka do katalogu konfiguracyjnego
`HanuBees_CONFIG_CONTENT`	string	Treść konfiguracji JSON (inline)
`HanuBees_DISABLE_AUTOUPDATE`	boolean	Wyłącz automatyczne sprawdzanie aktualizacji
`HanuBees_DISABLE_PRUNE`	boolean	Wyłącz czyszczenie starych wyników (pruning)
`HanuBees_DISABLE_TERMINAL_TITLE`	boolean	Wyłącz automatyczne ustawianie tytułu terminala
`HanuBees_PERMISSION`	string	Konfiguracja uprawnień w JSON (inline)
`HanuBees_DISABLE_DEFAULT_PLUGINS`	boolean	Wyłącz domyślne wtyczki
`HanuBees_DISABLE_LSP_DOWNLOAD`	boolean	Wyłącz automatyczne pobieranie serwerów LSP
`HanuBees_ENABLE_EXPERIMENTAL_MODELS`	boolean	Włącz modele eksperymentalne
`HanuBees_DISABLE_AUTOCOMPACT`	boolean	Wyłącz automatyczne kompaktowanie kontekstu
`HanuBees_DISABLE_CLAUDE_CODE`	boolean	Wyłącz integrację z `.claude` (prompt + skills)
`HanuBees_DISABLE_CLAUDE_CODE_PROMPT`	boolean	Wyłącz czytanie `~/.claude/CLAUDE.md`
`HanuBees_DISABLE_CLAUDE_CODE_SKILLS`	boolean	Wyłącz ładowanie `.claude/skills`
`HanuBees_DISABLE_MODELS_FETCH`	boolean	Wyłącz pobieranie modeli ze źródeł zewnętrznych
`HanuBees_FAKE_VCS`	string	Fałszywy dostawca VCS do celów testowych
`HanuBees_CLIENT`	string	Identyfikator klienta (domyślnie `cli`)
`HanuBees_ENABLE_EXA`	boolean	Włącz narzędzie wyszukiwania internetowego Exa
`HanuBees_SERVER_PASSWORD`	string	Włącz uwierzytelnianie podstawowe dla `serve`/`web`
`HanuBees_SERVER_USERNAME`	string	Nazwa użytkownika do autoryzacji (domyślnie `HanuBees`)
`HanuBees_MODELS_URL`	string	Niestandardowy adres URL do pobierania konfiguracji modeli

Eksperymentalne

Te zmienne włączają funkcje eksperymentalne, które mogą ulec zmianie lub zostać usunięte.

Zmienna	Typ	Opis
`HanuBees_EXPERIMENTAL`	boolean	Włącz funkcje eksperymentalne objęte flagą zbiorczą
`HanuBees_EXPERIMENTAL_ICON_DISCOVERY`	boolean	Włącz wykrywanie ikon
`HanuBees_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	Wyłącz kopiowanie przy zaznaczaniu w TUI
`HanuBees_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	Domyślny limit czasu dla narzędzia bash w ms
`HanuBees_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	Maksymalne tokeny wyjściowe dla LLM
`HanuBees_EXPERIMENTAL_FILEWATCHER`	boolean	Włącz obserwatora plików dla całego katalogu
`HanuBees_EXPERIMENTAL_OXFMT`	boolean	Włącz formater oxfmt
`HanuBees_EXPERIMENTAL_LSP_TOOL`	boolean	Włącz eksperymentalne narzędzie LSP
`HanuBees_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	Wyłącz obserwatora plików
`HanuBees_EXPERIMENTAL_EXA`	boolean	Włącz funkcje eksperymentalne Exa
`HanuBees_EXPERIMENTAL_LSP_TY`	boolean	Włącz TY LSP dla plików python
`HanuBees_EXPERIMENTAL_PLAN_MODE`	boolean	Włącz tryb planowania
`HanuBees_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	boolean	Włącz zadania subagentów w tle
`HanuBees_EXPERIMENTAL_EVENT_SYSTEM`	boolean	Włącz eksperymentalny system zdarzeń
`HanuBees_EXPERIMENTAL_NATIVE_LLM`	boolean	Włącz natywną ścieżkę żądań LLM
`HanuBees_EXPERIMENTAL_PARALLEL`	boolean	Włącz równoległe wykonywanie wyszukiwania web
`HanuBees_EXPERIMENTAL_SCOUT`	boolean	Włącz subagenta Scout
`HanuBees_EXPERIMENTAL_WORKSPACES`	boolean	Włącz obsługę obszarów roboczych