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

Polecenia Shella i TUI dla self-hosted Hermes Agent.

Page content

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

Hermes nie zamyka Cię na jednej platformie. Możesz korzystać z:

  • klasycznego interfejsu wiersza poleceń hermes / hermes chat,
  • pełnoekranowej sesji hermes --tui,
  • działającego w tle hermes gateway dla Telegrama, Discorda, Slacka i innych platform komunikacyjnych,
  • hermes dashboard dla lokalnego interfejsu w przeglądarce, gdy zainstalowany jest dodatek web.

Te ścieżki współdzielą tę samą konfigurację i dane w katalogu ~/.hermes; niniejsza strona zawiera listę poleceń shell, które mają znaczenie w tych trybach.

Ściągawka interfejsu CLI agenta Hermes — referencja terminala

Poniżej znajduje się szczegółowa referencja poleceń pogrupowana według zadań.

Instalacja agenta Hermes i polecenia CLI pierwszego uruchomienia

W przypadku instalacji i rozwiązywania problemów, zacznij od Asystent AI Hermes — Instalacja, Konfiguracja, Przepływ pracy i Rozwiązywanie problemów.

Instalator pobiera repozytorium, ustawia środowisko Pythona i podłącza plik wykonawczy hermes. Po wykonaniu source ~/.bashrc lub ~/.zshrc, Twoim domyślnym punktem wejścia do 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 Rozpocznij interaktywny czat po instalacji (domyślny codzienny punkt wejścia).
hermes --version / hermes version Wyświetla informacje o wersji.
hermes completion bash | zsh | fish Emituje skrypty autouzupełniania powłoki dla uzupełniania klawiszem Tab.
hermes update [--check] [--backup] [--restart-gateway] Pobiera najnowszy kod, ponownie instaluje zależności, opcjonalny snapshot domowy przed aktualizacją lub ponowne uruchomienie bramki.
hermes uninstall [--full] [--yes] Usuwa Hermesa; opcjonalne pełne usunięcie danych.

Natywny Windows nie jest wspierany; używaj WSL2. Instalacje na Androida przez Termux遵循 dedykowaną ścieżkę w dokumentacji upstream.

Globalne flagi dla każdego wywołania hermes

Te flagi stosują się przed podpoleceniami i zmieniają jaki profil, która sesja lub ile osobistej konfiguracji jest ładowane.

Flaga Opis
--profile, -p Wybiera profil Hermes na ten przebieg (nadpisuje trwały domyślny z hermes profile use).
--resume, -r Wznawia sesję po ID lub tytule.
--continue [name], -c Kontynuuje ostatnią sesję lub ostatnią pasującą do tytułu.
--worktree, -w Rozpoczyna w izolowanym worktree Git dla równoległych agentów.
--yolo Omija prompty zatwierdzenia niebezpiecznych poleceń (używaj ostrożnie).
--pass-session-id Zawiera ID sesji w podpowiedzi systemowej.
--ignore-user-config Pomija ~/.hermes/config.yaml (tylko wartości domyślne); .env nadal się ładuje.
--ignore-rules Pomija automatyczną wstrzykiwalność AGENTS.md, SOUL.md, .cursorrules, pamięci, wstępnie załadowanych umiejętności.
--tui Uruchamia TUI (równoważne HERMES_TUI=1).
--dev Z --tui, uruchamia źródła TS przez tsx do rozwoju TUI.

Izolowana automatyka często łączy hermes chat --ignore-user-config --ignore-rules z hermes -z dla powtarzalnych jednorazówek.

hermes chat, jednorazowe podpowiedzi i hermes -z

Polecenie / wzorzec Opis
hermes chat Interaktywny lub skryptowy czat; główna powierzchnia dla -q, -m, --provider, zestawów narzędzi, wznawiania, worktree, checkpointów.
hermes chat -q "..." Jednorazowa podpowiedź (nieinteraktywna); zachowuje bogatszy output niż -z, gdy działają narzędzia.
hermes -z "..." Skryptowy jednorazowiec — tylko ostateczna odpowiedź na stdout, bez banera ani szumu sesyjnego. Ten sam agent i narzędzia; najlepsze do rurek i skryptów.
hermes chat --quiet, -Q Cichszy tryb programistyczny (baner i podglądy narzędzi są tłumione).
-m / --model, --provider Nadpisywanie modelu i dostawcy dla przebiegu; zmienne środowiskowe HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER lustrzane zachowanie.
-t / --toolsets Włącza oddzielone przecinkami zestawy narzędzi dla przebiegu.
-s / --skills Wstępne załadowanie umiejętności (powtarzalne lub oddzielone przecinkami).
--image path Dołącza lokalny obraz do pojedynczego zapytania.
--checkpoints Włącza punkty kontrolne systemu plików przed destrukcyjnymi edycjami.
--max-turns N Ogranicza iteracje wywoływania 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. Polecenie slash /model tylko przełącza między już skonfigurowanymi dostawcami. Jeśli widzisz tylko OpenRouter w /model, wyjdź z sesji i dokończ hermes model.

Wybór modelu, puli uwierzytelniające i dostawcy zapasowi

Polecenie Opis
hermes model Interaktywny wybór dostawcy i modelu; klucze, OAuth, niestandardowe endpointy.
hermes auth Pule uwierzytelniające — add, list, remove, reset dla rotacyjnych kluczy i OAuth.
hermes fallback [list | add | remove | clear] Zarządzanie uporządkowanymi dostawcami zapasowymi, gdy główny błąd lub limituje.
hermes setup [model | tts | terminal | gateway | tools | agent] [...] Sekcjonowane lub pełne interaktywne setup (--quick, --reset, --non-interactive).

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

Wybór lokalnych endpointów zgodnych z OpenAI w porównaniu z hostowanymi API dla hermes model opiera się na tych samych kompromisach co ogólna hosting LLM (opóźnienie, koszty, operacje).

Gdy Twój domyślny kończy się na Qwen lub Gemma na czymś takim jak Ollama, domyślne ustawienia próbkowania mają równie duże znaczenie, co wpisany identyfikator modelu; zagregowane presety temperatury i kar kierowane do agentów znajdziesz w Parametry inferencji LLM agentic dla Qwen i Gemma.

Pliki konfiguracyjne i polecenia hermes config

Konfiguracja rozwiązuje się jako nadpisy CLI → config.yaml.env → 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 konfiguracji i env.
hermes config check Wykrywa brakujące lub przestarzałe ustawienia.
hermes config migrate Stosuje interaktywnie nowo wprowadzone opcje.

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 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 Usuń jedną sesję, wytnij 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 przywracaj archiwum profilu.
hermes profile alias Krótkie skrypty opakowujące dla szybkiego przełączania profili.

Używaj hermes -p work chat -q "..." dla doraźnych przebiegów bez zmiany trwałego domyślnego profilu.

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

Dla konfiguracji profilowej i umiejętności dostosowanych do rzeczywistych przepływów produkcyjnych według roli, zobacz Umiejętności Asystenta AI Hermes dla rzeczywistych konfiguracji produkcyjnych. W celu pisania i debugowania plików SKILL.md — metadane, stopniowe ujawnianie i warunkowa widoczność — zobacz Tworzenie umiejętności agenta Hermes — Struktura SKILL.md i najlepsze praktyki.

Polecenie Opis
hermes tools Interaktywne włączanie narzędzi per platforma; --summary wyświetla aktualne 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 URL.
hermes curator status, run, pause, pin, rollback, … Tłumaczenie: Konserwacja umiejętności w tle i bezpieczny rollback.
hermes hooks list, test, revoke, doctor Zadeklarowane haczyki powłoki i listy dozwolone w konfiguracji.
hermes plugins Składny UI lub podkomendy do instalacji, włączenia, wyłączenia i usuwania wtyczek.

Wbudowana pamięć i dostawcy hermes memory

Wbudowane MEMORY.md / USER.md pozostają aktywne; zewnętrzni dostawcy dodają opcjonalne warstwy pamięci. Aby dowiedzieć się, jak ta architektura zachowuje się w praktyce, przeczytaj System pamięci agenta Hermes — Jak realnie działa trwała pamięć AI. Aby porównać zewnętrzne backendy i kompromisy aktywacji, zobacz Porównanie dostawców pamięci agentów — Honcho, Mem0, Hindsight i pięć więcej.

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

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

Bramka komunikacyjna, sparowanie DM i platformy

Polecenie Opis
hermes gateway setup Interaktywny setup platformy komunikacyjnej.
hermes gateway run Bramka w 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 Instaluje lub usuwa usługę tła na poziomie użytkownika.
hermes pairing list | approve | revoke | clear-pending Zatwierdzenia sparowania DM dla botów komunikacyjnych.
hermes whatsapp Proces sparowania mostka WhatsApp.
hermes slack manifest Generuje manifest aplikacji Slack z parzystością poleceń slash bramki.

Na WSL, hermes gateway run wewnątrz tmux to odporny wzorzec, gdy gateway start zachowuje się nieprawidłowo. Dla end-to-end przepływów pracy na telefonie z użyciem tej samej warstwy bramki, zobacz Kontrola głosowa Hermes z telefonu. Dla operacji na serwerze dedykowanym z osobnym klientem desktopowym, postępuj zgodnie z Agent Hermes jako serwer headless i konfiguracja zdalnego pulpitu.

Planista cron, webhooki i Kanban

Polecenie Opis
hermes cron … Tworzenie, edycja, pauza, wznowienie, uruchomienie i usuwanie zaplanowanych podpowiedzi (tick dla ręcznego przebiegu planisty).
hermes webhook subscribe, list, remove, test Dynamiczne trasy webhooków dla przebiegów napędzanych zdarzeniami.
hermes kanban … Wieloprofilowa tablica zadań oparta na SQLite; dispatch steruje workerami.

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

hermes doctor, logi, kopie zapasowe i dane o użyciu

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] Przyjazny wklejaniu podsumowanie konfiguracji dla Discorda lub zgłoszeń na GitHubie.
hermes debug share Wgrywa zredagowany pakiet debug do usługi wklejania (lub --local).
hermes logs [agent | errors | gateway | list] Tail i filtrowanie logów w katalogu logów profilu.
hermes backup, hermes import Snapshoty 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ę triażu.

MCP, ACP, panel web i migracja z OpenClaw

Polecenie Opis
hermes mcp serve Uruchamia Hermesa jako serwer MCP.
hermes mcp add, remove, list, test, configure Zarządzanie połączeniami klienckimi MCP z Hermes.
hermes acp Serwer stdio protokołu klienta agenta dla edytorów (może być wymagana dodatkowa instalacja).
hermes dashboard [--port …] [--host …] Lokalny panel web (pip install hermes-agent[web]).
hermes claw migrate … Migruje konfiguracje w stylu OpenClaw do Hermes (--dry-run, presety, opcjonalne sekrety).

Migracja z OpenClawhermes claw migrate odczytuje tradycyjne katalogi domowe OpenClaw; pełne, stopniowe przejście, w tym przegląd dry-run, polityka konfliktów, obsługa sekretów i przekazanie kanału, jest omówione w Jak bezpiecznie migrować z OpenClaw do agenta Hermes. 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ą wrażliwe na wielkość liter; umiejętności rejestrują dodatkowe trasy /nazwa-umiejętności. Tabele poniżej są skuratowanym podzbiorem; pełny rejestr znajdziesz w oficjalnej dokumentacji agenta Hermes na końcu tego artykułu.

Przepływ sesji, zadania tła i cele

Polecenie Opis
/new, /reset Nowy ID sesji i historia.
/resume [name] Wznawia nazwaną sesję.
/compress [focus] Ręczna kompresja kontekstu z opcjonalnym tematem skupienia.
/retry, /undo Ponów ostatnią turę lub odrzuć ostatnią wymianę.
/title … Nazwij sesję dla późniejszego /resume.
/background …, /queue …, /steer … Równoległy przebieg tła, kolejka następnej podpowiedzi, popchnięcie w pętli po następnym narzędziu.
/goal … Trwały wieloturnowy cel z pętlą sędziego (status, pause, resume, clear).
/branch, /fork Rozgałęzia rozmowę dla alternatywnej eksploracji.

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 … Wyszukuje, instaluje i zarządza 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 analityczna.
/help, /quit Pomoc lub wyjście z CLI.

Aplikacje komunikacyjne (Telegram, Discord, Slack i inne) ujawniają nakładający się zestaw poleceń slash plus /approve, /restart, /commands i powiązane pomocnicze funkcje wyłącznie bramki — różnice platformowe są udokumentowane w referencji poleceń slash pod oficjalną dokumentacją agenta Hermes poniżej.

Więcej przydatnych lektur

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

Oficjalna dokumentacja agenta Hermes

Dokumentacja upstream na hermes-agent.nousresearch.com:


Wskazówka. Trzymaj hermes dump i hermes doctor --fix w pamięci mięśniowej — zamieniają niejasne raporty „coś się zepsuło" w działalne diffy wobec znanego dobrego setupu.

Subskrybuj

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