Karta ściągawka CLI Hermes Agent — komendy, flagi i skróty ze znakiem ukośnika

Polecenia Shella i TUI dla self-hosted agenta Hermes.

Page content

Hermes Agent od Nous Research to niezależny od modelu asystent korzystający z narzędzi, który możesz uruchamiać lokalnie lub na VPS, z poziomu powłoki (shell), pełnoekranowego interfejsu TUI lub bramy komunikacyjnej (messaging gateway).

Hermes nie wiąże Cię z jednym konkretnym interfejsem. Możesz korzystać z:

  • klasycznego CLI hermes / hermes chat,
  • pełnoekranowej sesji hermes --tui,
  • działającego w tle hermes gateway dla Telegrama, Discorda, Slcka i innych platform komunikacyjnych,
  • hermes dashboard dla lokalnego interfejsu przeglądarki, gdy zainstalowany jest dodatkowy moduł web.

Te ścieżki współdzielą ten sam plik konfiguracyjny i dane pod ~/.hermes; ta strona zawiera listę poleceń powłoki (shell), które mają znaczenie w tych trybach.

Ściągawka CLI Hermes Agent — referencja terminala

Poniżej znajduje się szczegółowa referencja poleceń pogrupowana według zadań, zweryfikowana w oparciu o oficjalną referencję poleceń CLI z dnia 6 października 2026 r. Najnowsza stabilna wersja oznaczona tagiem na ten dzień to v0.21.5 (v2026.9.24).

Instalacja Hermes Agent i polecenia CLI przy pierwszym uruchomieniu

Aby zainstalować i rozwiązywać problemy, zacznij od Hermes AI Assistant — Instalacja, konfiguracja, przepływ pracy i rozwiązywanie problemów.

Instalator pobiera repozytorium, konfiguruje środowisko Pythona i przygotowuje plik wykonywalny hermes. Po wykonaniu source ~/.bashrc lub ~/.zshrc, Twoim domyślnym punktem wejścia dla interaktywnego czatu jest po prostu hermes (ta sama rodzina 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 Uruchomienie interaktywnego czatu po instalacji (domyślny punkt wejścia na co dzień).
hermes --version / hermes version Wyświetla informacje o wersji.
hermes completion bash | zsh | fish Wyświetla skrypty autouzupełniania dla powłoki (tab completion).
hermes update [--check] [--backup] [--restart-gateway] Pobiera najnowszy kod, ponownie instaluje zależności, opcjonalnie tworzy snapshot katalogu domowego przed aktualizacją lub restartuje gateway.
hermes uninstall [--full] [--yes] Usuwa Hermes; opcjonalnie usuwa wszystkie dane.

Natywny system Windows nie jest obsługiwany; użyj WSL2. Instalacja na Androidzie przez Termux jest omówiona w dedykowanej sekcji dokumentacji źródłowej.

Globalne flagi dla każdego wywołania hermes

Te flagi stosuje się przed podpoleceniami i zmieniają jaki profil, która sesja lub jak wiele osobistej konfiguracji jest ładowanych.

Flag Opis
--profile, -p Wybiera profil Hermes na ten uruchomienie (nadmierza „lepki” domyślny z hermes profile use).
--resume, -r Wznawia sesję po ID lub tytule.
--continue [name], -c Kontynuuje najnowszą sesję lub najnowszą pasującą do tytułu.
--worktree, -w Uruchamia w izolowanym worktree Git dla równoległych agentów.
--yolo Ominie prompty zatwierdzania niebezpiecznych poleceń (uważaj).
--pass-session-id Dołącza ID sesji do promptu systemowego.
--ignore-user-config Pomija ~/.hermes/config.yaml (tylko wartości domyślne); .env nadal się ładuje.
--ignore-rules Pomija automatyczne wstrzykiwanie AGENTS.md, SOUL.md, .cursorrules, pamięci, prezaładowanych umiejętności.
--tui Uruchamia TUI (równoważnik HERMES_TUI=1).
--dev W połączeniu z --tui, uruchamia źródła TS przez tsx do rozwoju TUI.

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

hermes chat, jednokrotne prompty i hermes -z

Polecenie / wzorzec Opis
hermes chat Interaktywny lub skryptowany czat; główny interfejs dla -q, -m, --provider, zestawów narzędzi, wznawiania, worktree, checkpointów.
hermes chat -q "..." Na TTY, wysyła prompt jako pierwszą turę i pozostaje w sesji. Przed 0.21 kończyło się po jednej odpowiedzi.
hermes chat --oneshot -q "..." Odpowiada i kończy (stare zachowanie -q). Implikowane przez -Q i stdio poza TTY. Używaj tego, gdy potrzebujesz wyjścia narzędzi w transkrypcji.
hermes chat --query-file PATH Czyta prompt z pliku, lub - dla stdin. Nic nie jest interpretowane przez powłokę. Wzajemnie wykluczane z -q.
hermes -z "..." Skryptowane uruchomienie jednokrotne — tylko ostateczna odpowiedź na stdout, bez banera czy szumu sesji. Ten sam agent i narzędzia; najlepsze dla rur (pipes) i skryptów.
hermes -z "…" --usage-file PATH Po uruchomieniu -z, zapisuje raport JSON z użyciem (tokeny, koszt, completed / failed / partial), nawet gdy uruchomienie się nie powiedzie.
hermes chat -q "…" --format stream-json Zdarzenia JSONL na stdout (system, text, tool_use, tool_result, result). Implikuje tryb cichy; odrzuca --tui.
hermes chat --quiet, -Q Cichszy tryb programistyczny (baner i podglądy narzędzi są tłumione). Implikuje oneshot w połączeniu z -q.
-m / --model, --provider Nadpisanie modelu i dostawcy dla tego uruchomienia; zmienne środowiskowe HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER lustrują to zachowanie.
-t / --toolsets Włącza zestaw narzędzi rozdzielone przecinkami dla tego uruchomienia.
-s / --skills Prezaładuje umiejętności (powtarzalne lub rozdzielone przecinkami).
--image path Dołącza lokalny obraz do pojedynczego zapytania.
--checkpoints Włącza checkpointy systemu plików przed niszczącymi edycjami.
--max-turns N Limituje iteracje wywoływania narzędzi na turę (domyślnie 500, lub agent.max_turns w konfiguracji).
--safe-mode Wyłącza konfigurację użytkownika, reguły, pamięć, pluginy, hooki powłoki i MCP. Implikuje --ignore-user-config i --ignore-rules.
--source Tag źródła sesji (cli vs tool dla integracji). Uruchomienia jednokrotne domyślnie to oneshot.

Model Hermes poza sesją vs /model wewnątrz niej — Uruchamianie hermes model z powłoki to miejsce, w którym dodajesz dostawców, klucze i OAuth. Słowo klucz /model przełącza tylko między już skonfigurowanymi dostawcami. Jeśli widzisz tylko OpenRouter w /model, wyjdź z sesji i ukończ hermes model.

Kody wyjścia. Uruchomienie chat --oneshot / -Q kończy się kodem 0, gdy tura się zakończyła, 1, gdy się nie powiodła, zatrzymała w połowie, osiągnęła budżet iteracji lub nigdy nie wystartowała, oraz 130 przy przerwaniu. hermes -z używa innej mapy: 0 zakończone, 2 niepowodzenie lub częściowe (nawet jeśli wypisało wyjaśnienie), 1, gdy zakończona tura nie wygenerowała tekstu, 130 przy przerwaniu. Oceniaj pipeline po kodzie, a nie po tym, czy stdout jest pusty.

Wybór modelu, pula poświadczeń i dostawcy zapasowe

Polecenie Opis
hermes model Interaktywny wybór dostawcy i modelu; klucze, OAuth, niestandardowe punkty końcowe.
hermes auth Pule poświadczeń — add, list, remove, reset dla kluczy przyjaznych rotacji i OAuth.
hermes fallback [list | add | remove | clear] Zarządzanie uporządkowanymi dostawcami zapasowymi, gdy główny zgłasza błędy lub ograniczenia rate-limit.
hermes setup [model | tts | terminal | gateway | tools | agent] [...] Sekcyjna lub pełna interaktywna konfiguracja (--quick, --reset, --non-interactive).
hermes setup --portal Jednokrotne logowanie do Nous Portal: OAuth, ustawienie Nous jako dostawcy inferencji, opt-in do Tool Gateway.
hermes portal [status | open | tools] Stan uwierzytelnienia Portal i routing Tool Gateway. Bez podpolecenia uruchamia status.

hermes login zostało usunięte. Używaj hermes auth dla OAuth i pul poświadczeń, hermes model, aby wybrać dostawcę, lub hermes setup dla pełnego kreatora. hermes auth logout <provider> czyści zapisane logowanie.

Wybór lokalnych punktów końcowych kompatybilnych z OpenAI vs API hostowane dla hermes model opiera się na tych samych kompromisach, co ogólny Hosting LLM (opóźnienia, koszty, operacje).

Gdy Twój domyślny terminuje przy Qwen lub Gemma na czymś w rodzaju Ollama, wartości domyślne samplerów mają równie duże znaczenie, jak to, jaki identyfikator modelu wpisałeś; zgrupowane presetów temperatury i kar skierowane do agentów znajdziesz w Parametry inferencji LLM dla Qwen i Gemma dla agentów.

Pliki konfiguracyjne i polecenia hermes config

Konfiguracja rozwiązuje się jako nadpisanie CLI → config.yaml → .env → wartości domyślne. Klucze API należą do .env; ustawienia strukturalne do config.yaml.

Polecenie Opis
hermes config show Wyświetla efektywną konfigurację.
hermes config edit Otwiera config.yaml w $EDITOR.
hermes config set key value Ustawia wartości (sekrety kierowane do .env, niesekrety do YAML).
hermes config path / hermes config env-path Wyświetla ścieżki do plików konfiguracyjnych i env.
hermes config check Wykrywa brakujące lub przestarzałe ustawienia.
hermes config migrate Aplikuje 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 gatewaya i logów.

Zarządzanie sesjami i hermes profile

Polecenie Opis
hermes sessions list Lista ostatnich sesji.
hermes sessions browse Interaktywny wybór z wyszukiwaniem i wznawianiem.
hermes sessions export Eksport sesji (np. JSONL).
hermes sessions delete, prune, rename, stats Usuwa jedną sesję, usuwa stare, zmienia nazwy, pokazuje statystyki magazynu.
hermes profile list | use | create | delete | show | rename Zarządzanie izolowanymi instancjami Hermes na jednym komputerze.
hermes profile export / import Archiwizacja lub przywracanie kopii tarballa profilu.
hermes profile alias Krótkie skrypty opakowujące do szybkiego przełączania profili.
hermes worktree list Audyt roboczych worktree: wiek, rozmiar i czy każdy jest bezpieczny do usunięcia. --json dla skryptów.
hermes worktree prune Usuwa czyste, scalone drzewa robocze. --dry-run wyświetla plan; --older-than N tylko zawęża zakres. Drzewa z niezaangażowaną pracą lub unikalnymi commitami są zachowywane.

Używaj hermes -p work chat -q "..." dla ad hoc uruchomień bez zmiany „lepkiego” domyślnego profilu. Na TTY pozostaje w sesji; dodaj --oneshot, gdy uruchomienie profilu musi się zakończyć.

Hub umiejętności, zestawy narzędzi, hooki powłoki i pluginy

Dla konfiguracji z priorytetem profilu i umiejętności dopasowanych do rzeczywistych przepływów produkcyjnych według ról, zobacz Umiejętności Hermes AI Assistant dla rzeczywistych konfiguracji produkcyjnych. Dla pisania i debugowania plików SKILL.md — metadane, progresywne ujawnianie i warunkowa widoczność — zobacz Tworzenie umiejętności Hermes Agent — Struktura SKILL.md i najlepsze praktyki.

Polecenie Opis
hermes tools Interaktywne włączanie narzędzi na platformę; --summary wyświetla bieżące wybory.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config Przepływy pracy huba umiejętności, w tym rejestry i instalacje z URL.
hermes curator status, run, pause, pin, rollback, … Tła konserwacja umiejętności i bezpieczny rollback.
hermes hooks list, test, revoke, doctor Zadeklarowane hooki powłoki i białe listy w konfiguracji.
hermes plugins Złożony UI lub podpolecenia do instalowania, włączania, wyłączania i usuwania pluginów.

Wbudowana pamięć i dostawcy hermes memory

Wbudowane MEMORY.md / USER.md pozostają aktywne; zewnętrzni dostawcy dodają opcjonalne warstwy recall. Aby zrozumieć, 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 agenta — Honcho, Mem0, Hindsight i pięć innych.

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

Gdy dostawca jest aktywny, może zarejestrować dodatkowe, specyficzne dla niego górno-poziome podpolecenia — uruchom hermes --help, aby zobaczyć, co jest teraz podłączone.

Brama komunikacyjna, sparowanie DM i platformy

Polecenie Opis
hermes gateway setup Interaktywna konfiguracja platformy komunikacyjnej.
hermes gateway run Foregroundowy gateway (zalecane na WSL, Docker, Termux).
hermes gateway start | stop | restart | status Sterowanie serwisem systemd / launchd (--all wpływa na gateway każdego profilu).
hermes gateway install | uninstall Instalacja lub usuwanie użytkownikowego serwisu w tle.
hermes gateway migrate [--dry-run] Zbiera bramki per-profilowe na jednej hostowej bramce. hermes update wykonuje to, chyba że preflight to blokuje. Nie ma rollbacku --standalone.
hermes pairing list | approve | revoke | clear-pending Zatwierdzenia parowania DM dla botów komunikacyjnych.
hermes whatsapp Przepływ parowania mostka WhatsApp.
hermes slack manifest Generuje manifest aplikacji Slack z równością slash commands dla gatewaya.

Na WSL, hermes gateway run wewnątrz tmux jest odpornym wzorcem, gdy gateway start się źle zachowuje. Dla końcowych przepływów telefonowych używających tej samej warstwy gateway, zobacz Sterowanie głosowe Hermes z telefonu. Dla pracy na dedykowanym serwerze z osobnym klientem desktopowym, postępuj zgodnie z Serwer bezinterfejsowy Hermes Agent i ustawienie zdalnego pulpitu.

Planista Cron, webhooks i Kanban

Polecenie Opis
hermes cron … Tworzenie, edycja, pauza, wznawianie, uruchamianie, usuwanie zaplanowanych promptów (tick dla ręcznego przejścia planisty).
hermes webhook subscribe, list, remove, test Dynamiczne trasy webhooków dla uruchomień opartych na zdarzeniach.
hermes kanban … Wieloprofilowa tablica zadań oparta na SQLite; dispatch napędza workerów.

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

hermes doctor, logi, backup 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 sprawdzanie, gdy potrzebne.
hermes dump [--show-keys] Przyjazny dla wklejania podsumowanie ustawień dla Discorda lub problemów na GitHubie.
hermes debug share Wgrywa wyciętą pakiet debug do usługi pasty (lub --local).
hermes logs [agent | errors | gateway | list] Tail i filtrowanie logów pod katalogiem logów profilu.
hermes backup, hermes import Kopie zip danych domowych i ścieżki przywracania.
hermes insights [--days N] [--source …] Analiza tokenów, kosztów i aktywności.

Gdy coś się zepsuje po aktualizacji, hermes doctor, hermes status i hermes logs errors -f tworzą najszybszą pętlę triage.

MCP, ACP, web dashboard i migracja OpenClaw

Polecenie Opis
hermes mcp serve Uruchamia Hermes jako serwer MCP.
hermes mcp add, remove, list, test, configure Zarządzanie 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 web dashboard (pip install hermes-agent[web]).
hermes claw migrate … Migracja konfiguracji w stylu OpenClaw do Hermes (--dry-run, presetów, opcjonalne sekrety).
hermes import-agent [claude-code | codex] Import ustawienia Claude Code (~/.claude) lub Codex CLI (~/.codex). Zawsze najpierw podgląd; klucze API nigdy nie są kopiowane. --sync ponownie importuje źródła, których pliki się zmieniły.

Migracja OpenClaw — hermes claw migrate czyta starsze katalogi domowe OpenClaw; pełne, etapowe przełączenie, w tym przegląd dry-run, politykę konfliktów, obsługę sekretów i przekazanie kanału, jest omówione w Jak bezpiecznie migrować z OpenClaw do Hermes Agent. Dla tego, jak wyglądał ten stos przed przeniesieniem, zobacz Przypadek studyjny OpenClaw.

Polecenia slash w sesji CLI Hermes

Wpisz / dla autouzupełniania. Polecenia są wieloznaczeniowe (case-insensitive); umiejętności rejestrują dodatkowe trasy /skill-name. Poniższe tabele to kuratowany podzbiór; dla pełnego rejestru zobacz Oficjalną dokumentację Hermes Agent na końcu tego artykułu.

Przepływ sesji, zadania w tle i cele

Polecenie Opis
/new, /reset Nowe ID sesji i historia.
/resume [name] Wznawia nazwaną sesję.
/compress [focus] Ręczna kompresja kontekstu z opcjonalnym tematem skupienia.
/retry, /undo Ponawia ostatnią turę lub odrzuca ostatnią wymianę.
/title … Nadaje nazwę sesji dla późniejszego /resume.
/background …, /queue …, /steer … Równoległe uruchomienie w tle, kolejkowany następny prompt, korekta w trakcie pętli po następnym narzędziu.
/goal … Trwały wieloturnowy cel z pętlą sędziego (status, pause, resume, clear).
/branch, /fork Gałęzie konwersacji dla alternatywnych eksploracji.
/btw … Pytanie boczne o bieżącą konwersację; nie przerywa głównej tury.
/context [all] Rozbicie użycia kontekstu. all dodaje koszty per umiejętność i zestaw narzędzi.
/status Informacje o sesji plus lokalny podsumowanie (ostatnie tury, narzędzia, pliki). Bez wywołania modelu.
/sessions Wybór w sesji: filtr, strzałki, Enter do wznawiania.

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

Polecenie Opis
/model … [--global] Przełącza modele wśród skonfigurowanych dostawców; --global utrwalia domyślny.
/tools …, /toolsets Przełączniki narzędzi sesji i lista zestawów narzędzi.
/skills … Wyszukiwanie, instalowanie i zarządzanie umiejętnościami z czatu.
/cron … UI zadań zaplanowanych z sesji CLI.
/reload-mcp Przeładowuje serwery MCP z konfiguracji.
/reload Przeładowuje .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 analiz.
/voice on, /voice tts Nagrywanie głosu w CLI (Ctrl+B domyślnie) i odtwarzanie głosowe.
/reasoning high Podnosi wysiłek rozumowania dla sesji.
/help, /quit Pomoc lub wyjście z CLI.

Linia zaczynająca się od ! działa w powłoce hosta bez tury modelu (!git status). Nie wchodzi w konwersację, a niebezpieczne polecenia nadal trafiają na prompt zatwierdzenia. Ctrl+S ukrywa szkic kompozera tylko dla sesji; nic nie jest zapisywane na dysku.

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

Więcej przydatnych materiałów

Powiązane strony na tej stronie:

Oficjalna dokumentacja Hermes Agent

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

Wskazówka. Zachowaj hermes dump i hermes doctor --fix w pamięci mięśniowej — zamieniają mgliste raporty „coś się zepsuło" w wykonalne diffy względem znanej dobrej konfiguracji.

Subskrybuj

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