Ściąga do Hermes Agent CLI — polecenia, flagi i skróty po ukośniku

Komendy powłoki i interfejsu tekstowego (TUI) dla hostowanego samodzielnie agenta Hermes.

Page content

Hermes Agent od Nous Research to agnostyczny względem modelu asystent wykorzystujący narzędzia, który można uruchamiać lokalnie lub na serwerze VPS.

Hermes nie zmusza Cię do korzystania z jednego interfejsu. Możesz używać:

  • klasycznego wiersza poleceń hermes / hermes chat,
  • pełnoekranowej sesji hermes --tui,
  • działającego w tle hermes gateway do integracji z Telegramem, Discordem, Slackiem i innymi platformami komunikacyjnymi,
  • hermes dashboard dla lokalnego interfejsu przeglądarkowego, gdy zainstalowana jest dodatkowa funkcja web.

Te ścieżki współdzielą tę samą konfigurację i dane w katalogu ~/.hermes; na tej stronie wymieniono polecenia powłoki, które mają znaczenie we wszystkich trybach.

Ściągacz poleceń CLI Hermes Agent — odniesienie terminalowe

Poniżej znajduje się zwięzłe odniesienie do poleceń pogrupowane według zadań.

Instalacja Hermes Agent i polecenia CLI przy pierwszym uruchomieniu

Aby uzyskać informacje na temat instalacji i rozwiązywania problemów, zacznij od przewodnika Hermes AI Assistant — Instalacja, konfiguracja, przepływ pracy i rozwiązywanie problemów.

Skrypt instalacyjny pobiera repozytorium, ustawia środowisko Pythona i konfiguruje wykonywalny plik hermes. Po wykonaniu source ~/.bashrc lub ~/.zshrc, Twoim domyślnym punktem wejścia do interaktywnego czatu będzie po prostu hermes (z tej samej rodziny co hermes chat).

Polecenie Opis
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Oficjalna jednowierszowa instalacja (Linux, macOS, WSL2).
hermes / hermes chat Uruchom interaktywny czat po instalacji (domyślny dzienny punkt wejścia).
hermes --version / hermes version Wyświetl informacje o wersji.
hermes completion bash | zsh | fish Generuj skrypty uzupełniania powłoki dla uzupełniania tabulatora.
hermes update [--check] [--backup] [--restart-gateway] Pobrany najnowszy kod, zainstaluj ponownie zależności, opcjonalny snapshot domowego katalogu przed aktualizacją lub restart bramki.
hermes uninstall [--full] [--yes] Usuń Hermesa; opcjonalne pełne usunięcie danych.

Natywny system Windows nie jest obsługiwany; użyj WSL2. Instalacje na Androidzie przez Termux mają dedykowaną ścieżkę w dokumentacji źródłowej.

Globalne flagi dla każdego wywołania hermes

Te flagi stosowane są przed podkomendami i zmieniają jaki profil, jaką sesję lub ile konfiguracji użytkownika zostanie załadowanych.

Flag Opis
--profile, -p Wybierz profil Hermes dla tego uruchomienia (nadpisuje domyślny profil z hermes profile use).
--resume, -r Wznów sesję po ID lub tytule.
--continue [name], -c Kontynuuj najnowszą sesję, lub najnowszą pasującą do tytułu.
--worktree, -w Uruchom w izolowanym drzewie roboczym Git dla równoległych agentów.
--yolo Omijaj monity o zatwierdzenie niebezpiecznych poleceń (używaj z ostrożnością).
--pass-session-id Dołącz ID sesji do promptu systemowego.
--ignore-user-config Pomiń ~/.hermes/config.yaml (tylko wartości domyślne); .env nadal się ładuje.
--ignore-rules Pomiń automatyczne wstrzykiwanie AGENTS.md, SOUL.md, .cursorrules, pamięci, wstępnie załadowanych umiejętności.
--tui Uruchom interfejs TUI (równoważne HERMES_TUI=1).
--dev Z --tui, uruchom źródła TS przez tsx w celu rozwoju TUI.

Izolowana automatyzacja często łączy hermes chat --ignore-user-config --ignore-rules z hermes -z dla powtarzalnych uruchomień jednorazowych.

hermes chat, jednorazowe prompty i hermes -z

Polecenie / wzorzec Opis
hermes chat Interaktywny lub skryptowany czat; główny interfejs dla -q, -m, --provider, zestawów narzędzi, wznowienia, drzew roboczych, punktów kontrolnych.
hermes chat -q "..." Jednorazowy prompt (nieninteraktywny); zachowuje bogatszy output niż -z przy uruchamianiu narzędzi.
hermes -z "..." Skryptowany jednorazowy — tylko końcowa odpowiedź na stdout, bez nagłówków czy szumów sesyjnych. Ten sam agent i narzędzia; najlepsze do potów i skryptów.
hermes chat --quiet, -Q Ciszy programowy tryb (nagłówki i podglądy narzędzi są tłumione).
-m / --model, --provider Nadpisanie modelu i dostawcy dla danego uruchomienia; zmienne środowiskowe HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER odzwierciedlają to zachowanie.
-t / --toolsets Włącz zestaw narzędzi oddzielone przecinkami dla tego uruchomienia.
-s / --skills Wstępnie załaduj umiejętności (można powtarzać lub oddzielać przecinkami).
--image path Dołącz lokalny obraz do pojedynczego zapytania.
--checkpoints Włącz punkty kontrolne w systemie plików przed niszczycielskimi edycjami.
--max-turns N Limituj iteracje wywołań narzędzi na turę (domyślnie z konfiguracji).
--source Tag źródła sesji (cli vs tool dla integracji).

Model Hermes poza sesją vs /model wewnątrz niej — Uruchamianie hermes model z powłoki to miejsce, gdzie dodajesz dostawców, klucze i OAuth. Ukośnik /model służy tylko do przełączania między już skonfigurowanymi dostawcami. Jeśli widzisz tylko OpenRouter w /model, wyjdź z sesji i ukończ hermes model.

Wybór modelu, puli uwierzytelniania i dostawców zapasowych

Polecenie Opis
hermes model Interaktywny wybór dostawcy i modelu; klucze, OAuth, niestandardowe punkty końcowe.
hermes auth Pule uwierzytelniania — add, list, remove, reset dla przyjaznych dla rotacji kluczy i OAuth.
hermes fallback [list | add | remove | clear] Zarządzaj uporządkowanymi dostawcami zapasowymi, gdy podstawowy zgłasza błędy lub ograniczenia przepustowości.
hermes setup [model | tts | terminal | gateway | tools | agent] [...] Sekcyjna lub pełna interaktywna konfiguracja (--quick, --reset, --non-interactive).

Przestarzałe hermes login / hermes logout — użyj zamiast tego hermes auth i hermes model.

Wybór lokalnych punktów końcowych kompatybilnych z OpenAI versus hostowanych API dla hermes model opiera się na tych samych kompromisach co ogólne hostowanie LLM (opóźnienie, koszt, operacje).

Pliki konfiguracyjne i polecenia hermes config

Konfiguracja rozwiązywana jest jako nadpisanie CLI → config.yaml.env → wartości domyślne. Klucze API powinny znajdować się w .env; ustawienia strukturalne w config.yaml.

Polecenie Opis
hermes config show Wyświetl skuteczną konfigurację.
hermes config edit Otwórz config.yaml w $EDITOR.
hermes config set key value Ustaw wartości (sekrety trafiają do .env, inne do YAML).
hermes config path / hermes config env-path Wyświetl ścieżki do plików konfiguracyjnych i środowiskowych.
hermes config check Wykryj brakujące lub przestarzałe ustawienia.
hermes config migrate Zastosuj nowo wprowadzone opcje interaktywnie.

Gdzie znajdują się pliki — Wszystko znajduje się pod HERMES_HOME (domyślnie ~/.hermes) dla konfiguracji, sekretów, pamięci, umiejętności, sesji, stanu bramki i logów.

Zarządzanie sesjami i hermes profile

Polecenie Opis
hermes sessions list Wyświetl ostatnie sesje.
hermes sessions browse Interaktywny wybór z wyszukiwaniem i wznowieniem.
hermes sessions export Eksportuj sesje (np. JSONL).
hermes sessions delete, prune, rename, stats Usuń jedną sesję, obetnij stare, zmień nazwy tytułów, pokaż statystyki magazynu.
hermes profile list | use | create | delete | show | rename Zarządzaj izolowanymi instancjami Hermes na jednej maszynie.
hermes profile export / import Archiwizuj lub przywróć archiwum profilu.
hermes profile alias Krótkie skrypty opakowujące dla szybkiego przełączania profili.

Użyj hermes -p work chat -q "..." dla uruchomień ad hoc bez zmiany domyślnego profilu.

Centrum umiejętności, zestawy narzędzi, haki powłoki i wtyczki

Aby uzyskać konfigurację opartą na profilach i umiejętności dostosowane do rzeczywistych przepływów produkcyjnych według roli, zobacz Hermes AI Assistant Skills for Real Production Setups.

Polecenie Opis
hermes tools Interaktywne włączanie narzędzi na platformę; --summary wypisuje bieżące wybory.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config Przepływy pracy centrum umiejętności, w tym rejestrach i instalacjach przez URL.
hermes curator status, run, pause, pin, rollback, … Tłumione utrzymanie umiejętności i bezpieczne cofanie.
hermes hooks list, test, revoke, doctor Zadeklarowane haki powłoki i listy dozwolonych w konfiguracji.
hermes plugins Skomponowany interfejs UI lub podkomendy do instalowania, włączania, wyłączania, usuwania wtyczek.

Wbudowana pamięć i dostawcy hermes memory

Wbudowane MEMORY.md / USER.md pozostają aktywne; zewnętrzni dostawcy dodają opcjonalne warstwy odwołania. Aby dowiedzieć się, jak ta architektura zachowuje się w praktyce, przeczytaj Hermes Agent Memory System — How Persistent AI Memory Actually Works. Aby porównać zewnętrzne zaplecza i kompromisy aktywacji, zobacz Agent Memory Providers Compared — Honcho, Mem0, Hindsight, and Five More.

Polecenie Opis
hermes memory setup Interaktywna konfiguracja zewnętrznego dostawcy pamięci.
hermes memory status Wyświetl aktywne ustawienia dostawcy.
hermes memory off Wyłącz zewnętrznego dostawcę; wbudowane pliki pozostają.

Gdy dostawca jest aktywny, może rejestrować dodatkowe specyficzne dla dostawcy podkomendy najwyższego poziomu — uruchom hermes --help, aby zobaczyć, co jest obecnie podłączone.

Bramka komunikacyjna, parowanie DM i platformy

Polecenie Opis
hermes gateway setup Interaktywna konfiguracja platform komunikacyjnych.
hermes gateway run Bramka na pierwszym planie (zalecane na WSL, Docker, Termux).
hermes gateway start | stop | restart | status Kontrola usług systemd / launchd (--all wpływa na bramkę każdego profilu).
hermes gateway install | uninstall Zainstaluj lub usuń usługę tła użytkownika.
hermes pairing list | approve | revoke | clear-pending Zatwierdzenia parowania DM dla botów komunikacyjnych.
hermes whatsapp Przepływ parowania mostu WhatsApp.
hermes slack manifest Generuj manifest aplikacji Slack z parzystością ukośników bramki.

Na WSL, hermes gateway run wewnątrz tmux jest odpornym wzorcem, gdy gateway start zachowuje się nieprawidłowo.

Kalendarz Cron, webhuki i Kanban

Polecenie Opis
hermes cron … Twórz, edytuj, wstrzymuj, wznawiaj, uruchamiaj, usuwaj zaplanowane prompty (tick dla ręcznego przejścia kalendarza).
hermes webhook subscribe, list, remove, test Dynamiczne trasy webhooków dla uruchomień napędzanych zdarzeniami.
hermes kanban … Wieloprofilowa tablica zadań oparta na SQLite; dispatch napędza pracowniki.

hermes doctor, logi, kopie zapasowe i wgląd w użycie

Polecenie Opis
hermes doctor [--fix] Interaktywna diagnostyka i opcjonalna automatyczna naprawa.
hermes status [--all] [--deep] Zwięzły status; głębsze sprawdzenia, gdy potrzebne.
hermes dump [--show-keys] Przyjazne dla wklejania podsumowanie konfiguracji dla Discorda lub zgłoszeń GitHub.
hermes debug share Prześlij zredagowane pakiet debuggowania do usługi wklejania (lub --local).
hermes logs [agent | errors | gateway | list] Śledź i filtruj logi w katalogu logów profilu.
hermes backup, hermes import Archiwy zip danych domowych i ścieżki przywracania.
hermes insights [--days N] [--source …] Analiza tokenów, kosztów i aktywności.

Gdy coś się psuje po aktualizacji, hermes doctor, hermes status i hermes logs errors -f tworzą najszybszą pętlę triażu.

MCP, ACP, panel webowy i migracja OpenClaw

Polecenie Opis
hermes mcp serve Uruchom Hermesa jako serwer MCP.
hermes mcp add, remove, list, test, configure Zarządzaj połączeniami klienta MCP z Hermes.
hermes acp Serwer stdio protokołu Agent Client Protocol dla edytorów (może wymagać dodatkowej instalacji).
hermes dashboard [--port …] [--host …] Lokalny panel webowy (pip install hermes-agent[web]).
hermes claw migrate … Migruj konfiguracje stylu OpenClaw do Hermes (--dry-run, predefinicje, opcjonalne sekrety).

Migracja OpenClawhermes claw migrate odczytuje legacy katalogi domowe OpenClaw; aby zobaczyć, jak ten stos wyglądał przed przeniesieniem, zobacz OpenClaw case study.

Polecenia ukośnikowe w sesji CLI Hermes

Naciśnij /, aby uzyskać uzupełnianie. Polecenia są nieczułe na wielkość liter; umiejętności rejestrują dodatkowe trasy /skill-name. Poniższe tabele to skurczony podzbiór; pełny rejestr znajdziesz w Oficjalnej dokumentacji Hermes Agent na końcu tego artykułu.

Przepływ sesji, zadania tła i cele

Polecenie Opis
/new, /reset Nowe ID sesji i historia.
/resume [name] Wznów nazwaną sesję.
/compress [focus] Ręczna kompresja kontekstu z opcjonalnym tematem skupienia.
/retry, /undo Ponów ostatnią turę lub usuń ostatnią wymianę.
/title … Nazwij sesję dla późniejszego /resume.
/background …, /queue …, /steer … Równoległe uruchomienie tła, kolejka następnego promptu, korekta w pętli po następnym narzędziu.
/goal … Trwały wieloturnowy cel z pętlą sędziowską (status, pause, resume, clear).
/branch, /fork Rozgałęź rozmowę w celu alternatywnej eksploracji.

Modele, przełączniki narzędzi, umiejętności i przeładowanie

Polecenie Opis
/model … [--global] Przełączaj modele między skonfigurowanymi dostawcami; --global utrzymuje domyślny.
/tools …, /toolsets Przełączniki narzędzi sesyjnych i lista zestawów narzędzi.
/skills … Wyszukuj, instaluj i zarządzaj umiejętnościami z czatu.
/cron … Interfejs UI zadań zaplanowanych z sesji CLI.
/reload-mcp Przeładuj serwery MCP z konfiguracji.
/reload Przeładuj .env do działającej sesji bez restartu.

Użycie, pomoc i wyjście

Polecenie Opis
/usage, /insights Widoczność tokenów i kosztów; snapshot analityczny.
/help, /quit Pomoc lub wyjście z CLI.

Aplikacje komunikacyjne (Telegram, Discord, Slack i inne) eksponują nakładający się zestaw ukośników plus /approve, /restart, /commands i powiązane pomocniki tylko bramkowe — różnice platformowe są udokumentowane w odniesieniu do poleceń ukośnikowych pod Oficjalną dokumentacją Hermes Agent poniżej.

Więcej przydatnych materiałów

Powiązane strony na tej stronie (szerszy kontekst dla Hermes i agentów terminalowych):

Oficjalna dokumentacja Hermes Agent

Dokumentacja źródłowa na hermes-agent.nousresearch.com:


Wskazówka. Trzymaj hermes dump i hermes doctor --fix w pamięci mięśniowej — zamieniają one nieokreślone raporty “coś się zepsuło” w działające diffy względem znanego, dobrego ustawienia.

Subskrybuj

Otrzymuj nowe wpisy o systemach, infrastrukturze i inżynierii AI.