Ś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.
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 gatewaydo integracji z Telegramem, Discordem, Slackiem i innymi platformami komunikacyjnymi, hermes dashboarddla 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.

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 OpenClaw — hermes 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):
- AI Systems — Self-Hosted Assistants, RAG, and Local Infrastructure — przegląd klastra i jak asystenci pasują do stosu
- AI Systems Memory — hub pamięci i powiązane przewodniki
- AI Developer Tools — krajobraz narzędzi terminalowych i IDE
- OpenCode Quickstart — kolejny agent terminal-first do ergonomicznego porównania
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.