Ściąga do CLI agenta Hermes — polecenia, flagi i skróty z ukośnikiem

Polecenia Shell i TUI dla samodzielnie hostowanego agenta Hermes.

Page content

Hermes Agent od firmy Nous Research to asystent wykorzystujący narzędzia, niezależny od modelu, którego można uruchamiać lokalnie lub na serwerze VPS.

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

  • klasycznego interfejsu CLI hermes / hermes chat,
  • sesji pełnoekranowej hermes --tui,
  • długotrwałego procesu hermes gateway dla platform komunikacyjnych takich jak Telegram, Discord, Slack i innych,
  • hermes dashboard dla lokalnego interfejsu przeglądarkowego po zainstalowaniu dodatku web.

Te ścieżki wykorzystują tę samą konfigurację i dane przechowywane w katalogu ~/.hermes; niniejsza strona zawiera polecenia powłoki istotne dla wszystkich tych trybów.

Ściągarka CLI Hermes Agent — referencja terminala

Poniżej znajduje się zwięzła referencja poleceń pogrupowana według zadań.

Instalacja Hermes Agent i polecenia CLI przy pierwszym uruchomieniu

W przypadku instalacji i rozwiązywania problemów zacznij od Instalacja, konfiguracja, przepływ pracy i rozwiązywanie problemów asystenta AI Hermes.

Skrypt instalacyjny pobiera repozytorium, konfiguruje środowisko Pythona i łączy wykonywalny plik hermes. Po wykonaniu source ~/.bashrc lub ~/.zshrc, Twoim domyślnym punktem wejścia do interaktywnego czatu jest 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 jednolinijkowa instalacja (Linux, macOS, WSL2).
hermes / hermes chat Uruchom interaktywny czat po instalacji (domyślne codzienne wejście).
hermes --version / hermes version Wyświetl informacje o wersji.
hermes completion bash | zsh | fish Wygeneruj skrypty autouzupełniania dla powłoki.
hermes update [--check] [--backup] [--restart-gateway] Pobrany najnowszy kod, zainstaluj ponownie zależności, opcjonalne utworzenie kopii zapasowej katalogu domowego lub restart bramki przed aktualizacją.
hermes uninstall [--full] [--yes] Usuń Hermes; opcjonalne pełne usunięcie danych.

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

Globalne flagi dla każdego wywołania hermes

Te flagi stosuje się przed podpoleceniami i zmieniają który profil, którą sesję lub jaką część konfiguracji użytkownika załadować.

Flag Opis
--profile, -p Wybierz profil Hermes dla tego uruchomienia (następuje nadpisanie domyślnego profilu wybranego przez 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 Rozpocznij w izolowanym drzewie roboczym Git dla równoległych agentów.
--yolo Omijaj monity o zatwierdzenie niebezpiecznych poleceń (używaj ostrożnie).
--pass-session-id Dołącz ID sesji do promptu systemowego.
--ignore-user-config Pomiń ~/.hermes/config.yaml (tylko wartości domyślne); plik .env jest nadal ładowany.
--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żnik HERMES_TUI=1).
--dev Przy --tui, uruchom źródła TS przez tsx w celu dewelopacji TUI.

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

hermes chat, jednorazowe prompty i hermes -z

Polecenie / wzorzec Opis
hermes chat Interaktywny lub skryptowy czat; główny interfejs dla -q, -m, --provider, zestawów narzędzi, wznowienia, drzewa roboczego, punktów kontrolnych.
hermes chat -q "..." Jednorazowy prompt (nieinteraktywny); zachowuje bogatszą strukturę wyjścia niż -z przy uruchamianiu narzędzi.
hermes -z "..." Skryptowa jednorazowa komenda — tylko ostateczna odpowiedź na stdout, bez nagłówków czy szumu sesyjnego. Ten sam agent i narzędzia; najlepsze do potoków i skryptów.
hermes chat --quiet, -Q Cichszy tryb programowy (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 zestawy narzędzi oddzielone przecinkami dla tego uruchomienia.
-s / --skills Wstępnie załaduj umiejętności (można powtarzać lub oddzielać przecinkami).
--image path Załącz lokalny obraz do pojedynczego zapytania.
--checkpoints Włącz punkty kontrolne na systemie plików przed niszczycielskimi edycjami.
--max-turns N Ogranicz liczbę iteracji 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. Używanie /model przyciskuSlash pozwala tylko przełączać się między już skonfigurowanymi dostawcami. Jeśli widzisz tylko OpenRouter w /model, opuść sesję i dokończ konfigurację przez 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 główny zgłasza błędy lub ograniczenia przepustowości.
hermes setup [model | tts | terminal | gateway | tools | agent] [...] Podzielona 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 w przeciwieństwie do hostowanych API dla hermes model opiera się na tych samych kompromisach co ogólna infrastruktura hostowania LLM (opóźnienie, koszt, operacje).

Gdy Twój domyślny model kończy się na Qwen lub Gemma na czymś takim jak Ollama, domyślne ustawienia samplerze są równie ważne jak wybrany ID modelu; z agregatowymi ustawieniami temperatury i penalizacji dla agentów zapoznaj się w Parametry wnioskowania agencjalnego LLM dla Qwen i Gemma.

Pliki konfiguracyjne i polecenia hermes config

Konfiguracja rozwiązywana jest w kolejności: nadpisanie CLI → config.yaml.env → wartości domyślne. Klucze API powinny znajdować się w .env, a strukturalne ustawienia 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, pozostałe 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 dziennikó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ę, wyczyń stare, zmień tytuły, 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óć profil z archiwum tarball.
hermes profile alias Krótkie skrypty opakowujące dla szybkiego przełączania profili.

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

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

Dla konfiguracji opartej na profilach i umiejętnościach dostosowanych do rzeczywistych przepływów produkcyjnych według ról, zobacz Umiejętności asystenta AI Hermes dla rzeczywistych setupów produkcyjnych. Dla pisania i debugowania plików SKILL.md — metadanych, stopniowej ujawniania i warunkowej widoczności — zobacz Tworzenie umiejętności Hermes Agent — struktura SKILL.md i najlepsze praktyki.

Polecenie Opis
hermes tools Interaktywne włączanie narzędzi dla platform; --summary drukuje aktualne 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 rejestrów i instalacji z URL.
hermes curator status, run, pause, pin, rollback, … Tłowe utrzymanie umiejętności i bezpieczne cofanie.
hermes hooks list, test, revoke, doctor Deklarowane haczyki powłoki i listy dozwolonych w konfiguracji.
hermes plugins Skompletowany interfejs UI lub podpolecenia do instalacji, 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 wywoływania. Aby dowiedzieć się, jak ta architektura zachowuje się w praktyce, przeczytaj System pamięci Hermes Agent — jak naprawdę działa trwała pamięć AI. Aby porównać zewnętrzne bazy danych i kompromisy aktywacji, zobacz Porównanie dostawców pamięci agentów — Honcho, Mem0, Hindsight i pięć innych.

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

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

Brama komunikacyjna, parowanie DM i platformy

Polecenie Opis
hermes gateway setup Interaktywna konfiguracja platform komunikacyjnych.
hermes gateway run Brama na pierwszym planie (zalecane na WSL, Docker, Termux).
hermes gateway start | stop | restart | status Kontrola usługi systemd / launchd (--all wpływa na bramkę każdego profilu).
hermes gateway install | uninstall Zainstaluj lub usuń usługę tła na poziomie 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ą slashów bramki.

Na WSL, hermes gateway run wewnątrz tmux jest odpornym wzorcem, gdy gateway start zachowuje się nieprawidłowo. Dla przepływów pracy telefonów end-to-end wykorzystujących tę samą warstwę bramki, zobacz Kontrola głosowa Hermes z telefonu. Dla działania na dedykowanym serwerze z osobnym klientem desktopowym, postępuj zgodnie z Konfiguracja bezgłowego serwera Hermes Agent i zdalnego pulpitu.

Harmonogram Cron, webhooki i Kanban

Polecenie Opis
hermes cron … Twórz, edytuj, wstrzymuj, wznawiaj, uruchamiaj, usuwaj zaplanowane prompty (tick dla ręcznego przejścia harmonogramu).
hermes webhook subscribe, list, remove, test Dynamiczne trasy webhooków dla uruchomień napędzanych zdarzeniami.
hermes kanban … Tablica zadań wieloprofilowa wspierana przez SQLite; dispatch napędza workerów.

Jeśli potrzebujesz praktycznych wzorców konkurencji dla hermes kanban na samodzielnie hostowanych bramkach, zobacz Kanban w Hermes Agent dla samodzielnie hostowanych przepływów LLM.

hermes doctor, logi, kopie zapasowe i analizy użycia

Polecenie Opis
hermes doctor [--fix] Interaktywna diagnostyka i opcjonalna automatyczna naprawa.
hermes status [--all] [--deep] Zwięzły status; głębsze sprawdzenia przy необходимости.
hermes dump [--show-keys] Przyjazna dla wklejania podsumowanie setupu dla Discorda lub zgłoszeń GitHub.
hermes debug share Prześlij zanonimizowaną paczkę debugową do usługi pastebin (lub --local).
hermes logs [agent | errors | gateway | list] Śledź i filtruj logi w katalogu dzienników profilu.
hermes backup, hermes import Archiwa Zip danych domowych i ścieżki przywracania.
hermes insights [--days N] [--source …] Tokeny, koszty i analizy 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 Hermes 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 w stylu OpenClaw do Hermes (--dry-run, preset, opcjonalne sekrety).

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

Polecenia slash w sesji CLI Hermes

Wpisz / dla autouzupełniania. Polecenia są wielkość liter nieważna; umiejętności rejestrują dodatkowe trasy /skill-name. Poniższe tabele to skuratowany 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 Powtórz ostatni turę lub odrzuć ostatnią wymianę.
/title … Nazwij sesję dla późniejszego /resume.
/background …, /queue …, /steer … Równoległe uruchomienie w tle, kolejka następnego promptu, korekta w pętli po następnym narzędziu.
/goal … Trwały wieloturzeniowy cel z pętlą sędziego (status, pause, resume, clear).
/branch, /fork Rozgałęź konwersację dla alternatywnej eksploracji.

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

Polecenie Opis
/model … [--global] Przełączaj modele między skonfigurowanymi dostawcami; --global utrwal domyślny.
/tools …, /toolsets Przełączniki narzędzi sesyjnych i lista zestawów narzędzi.
/skills … Szukaj, instaluj i zarządzaj umiejętnościami z czatu.
/cron … UI zadań harmonogramu z sesji CLI.
/reload-mcp Ponownie załaduj serwery MCP z konfiguracji.
/reload Ponownie zał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; migawka analityczna.
/help, /quit Pomoc lub wyjście z CLI.

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

Więcej przydatnej lektury

Powiązane strony na tej witrynie (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 niejasne raporty “coś się zepsuło” w działające diffy w stosunku do sprawdzonej konfiguracji.

Subskrybuj

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