Шпаргалка по Hermes Agent CLI — команды, флаги и сокращения с косой чертой

Hermes Agent от Nous Research — это модельно-независимый ассистент, использующий инструменты, который вы можете запускать локально или на VPS.

Hermes не ограничивает вас одним интерфейсом. Вы можете использовать:

• классический CLI hermes / hermes chat,
• полноэкранную сессию hermes --tui,
• длительно работающий hermes gateway для Telegram, Discord, Slack и других платформ мессенджинга,
• hermes dashboard для локального пользовательского интерфейса в браузере при установленном веб-дополнении.

Все эти способы используют одни и те же конфигурацию и данные в директории ~/.hermes; на этой странице перечислены команды оболочки, важные для всех этих режимов.

Ниже представлен концентрированный справочник команд, сгруппированный по задачам.

Установка Hermes Agent и команды CLI для первого запуска

Для установки и устранения неполадок начните с Hermes AI Assistant — Установка, настройка, рабочий процесс и устранение неполадок.

Скрипт установки загружает репозиторий, настраивает окружение Python и связывает исполняемый файл hermes. После выполнения source ~/.bashrc или ~/.zshrc, вашей точкой входа по умолчанию для интерактивного чата становится простая команда hermes (из того же семейства, что и hermes chat).

Команда	Описание
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash	Официальная однострочная установка (Linux, macOS, WSL2).
hermes / hermes chat	Запуск интерактивного чата после установки (основной способ ежедневного входа).
hermes --version / hermes version	Вывод информации о версии.
hermes completion bash | zsh | fish	Генерация скриптов автодополнения оболочки для завершения по Tab.
hermes update [--check] [--backup] [--restart-gateway]	Получение последнего кода, переустановка зависимостей; опциональное создание снимка домашней директории перед обновлением или перезапуск шлюза.
hermes uninstall [--full] [--yes]	Удаление Hermes; опциональное полное удаление данных.

Нативная Windows не поддерживается; используйте WSL2. Установка на Android через Termux следует отдельному пути, описанному в исходной документации.

Глобальные флаги для каждого вызова hermes

Эти флаги применяются до подкоманд и изменяют профиль, сессию или объем загружаемой личной конфигурации.

Флаг	Описание
--profile, -p	Выбор профиля Hermes для этого запуска (перезаписывает «липкий» профиль по умолчанию из hermes profile use).
--resume, -r	Возобновление сессии по ID или названию.
--continue [name], -c	Продолжение последней сессии или последней сессии, соответствующей названию.
--worktree, -w	Запуск в изолированной рабочей ветке Git (worktree) для параллельных агентов.
--yolo	Обход запросов на подтверждение опасных команд (использовать с осторожностью).
--pass-session-id	Включение ID сессии в системный промпт.
--ignore-user-config	Пропуск ~/.hermes/config.yaml (используются только значения по умолчанию); .env все равно загружается.
--ignore-rules	Пропуск автоматического внедрения AGENTS.md, SOUL.md, .cursorrules, памяти, предварительно загруженных навыков.
--tui	Запуск TUI (эквивалент HERMES_TUI=1).
--dev	С флагом --tui, запуск исходников TS через tsx для разработки TUI.

Изолированная автоматизация часто сочетает hermes chat --ignore-user-config --ignore-rules с hermes -z для воспроизводимых однострочных задач.

hermes chat, однострочные промпты и hermes -z

Команда / паттерн	Описание
hermes chat	Интерактивный или скриптовый чат; основной интерфейс для -q, -m, --provider, наборов инструментов, возобновления, рабочей ветки, контрольных точек.
hermes chat -q "..."	Однострочный промпт (неинтерактивный); сохраняет более богатый вывод, чем -z, когда выполняются инструменты.
hermes -z "..."	Скриптовый однострочник — только финальный ответ в stdout, без баннеров или шума сессии. Тот же агент и инструменты; идеально для конвейеров (pipes) и скриптов.
hermes chat --quiet, -Q	Более тихий программный режим (подавлены баннер и превью инструментов).
-m / --model, --provider	Переопределение модели и провайдера для одного запуска; переменные окружения HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER дублируют это поведение.
-t / --toolsets	Включение наборов инструментов, разделенных запятыми, для сессии.
-s / --skills	Предварительная загрузка навыков (можно повторять или разделять запятыми).
--image path	Прикрепление локального изображения к одному запросу.
--checkpoints	Включение контрольных точек файловой системы перед разрушительными изменениями.
--max-turns N	Ограничение итераций вызова инструментов за ход (по умолчанию из конфигурации).
--source	Тег источника сессии (cli vs tool для интеграций).

Модель Hermes вне сессии vs /model внутри неё — Запуск hermes model из оболочки — это место, где вы добавляете провайдеры, ключи и OAuth. Слэш-команда /model переключает только между уже настроенными провайдерами. Если в /model вы видите только OpenRouter, выйдите из сессии и завершите настройку через hermes model.

Выборщик моделей, пулы учетных данных и резервные провайдеры

Команда	Описание
hermes model	Интерактивный выбор провайдера и модели; ключи, OAuth, пользовательские конечные точки.
hermes auth	Пулы учетных данных — add, list, remove, reset для удобного вращения ключей и OAuth.
hermes fallback [list | add | remove | clear]	Управление упорядоченными резервными провайдерами при ошибках или ограничении скорости основного.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Секционированная или полная интерактивная настройка (--quick, --reset, --non-interactive).

Устаревшие hermes login / hermes logout — используйте вместо них hermes auth и hermes model.

Выбор локальных конечных точек, совместимых с OpenAI, против хостинговых API для hermes model, обусловлен теми же компромиссами, что и общий хостинг LLM. (задержка, стоимость, операционные расходы).

Файлы конфигурации и команды hermes config

Конфигурация разрешается в порядке: переопределения CLI → config.yaml → .env → значения по умолчанию. API-ключи должны находиться в .env; структурированные настройки — в config.yaml.

Команда	Описание
hermes config show	Отображение эффективной конфигурации.
hermes config edit	Открытие config.yaml в $EDITOR.
hermes config set key value	Установка значений (секреты направляются в .env, несекретные — в YAML).
hermes config path / hermes config env-path	Вывод путей к файлам конфигурации и окружения.
hermes config check	Обнаружение отсутствующих или устаревших настроек.
hermes config migrate	Интерактивное применение новых опций.

Где находятся файлы — Все находится под HERMES_HOME (по умолчанию ~/.hermes) для конфигурации, секретов, памяти, навыков, сессий, состояния шлюза и логов.

Управление сессиями и hermes profile

Команда	Описание
hermes sessions list	Список последних сессий.
hermes sessions browse	Интерактивный выборщик с поиском и возобновлением.
hermes sessions export	Экспорт сессий (например, в JSONL).
hermes sessions delete, prune, rename, stats	Удаление одной сессии, очистка старых, переименование названий, отображение статистики хранилища.
hermes profile list | use | create | delete | show | rename	Управление изолированными экземплярами Hermes на одной машине.
hermes profile export / import	Архивация или восстановление тарбола профиля.
hermes profile alias	Короткие обертки-скрипты для быстрого переключения профилей.

Используйте hermes -p work chat -q "..." для ad hoc запусков без изменения «липкого» профиля по умолчанию.

Центр навыков, наборы инструментов, хуки оболочки и плагины

Для конфигурации, ориентированной на профили, и навыков, настроенных на реальные производственные рабочие процессы по ролям, см. Навыки AI-ассистента Hermes для реальных производственных настроек.

Команда	Описание
hermes tools	Интерактивное включение инструментов для платформы; --summary выводит текущие выборы.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config	Рабочие процессы центра навыков, включая реестры и установку по URL.
hermes curator status, run, pause, pin, rollback, …	Фоновое обслуживание навыков и безопасный откат.
hermes hooks list, test, revoke, doctor	Объявленные хуки оболочки и списки разрешений в конфигурации.
hermes plugins	Композитный UI или подкоманды для установки, включения, отключения, удаления плагинов.

Встроенная память и провайдеры hermes memory

Встроенные файлы MEMORY.md / USER.md остаются активными; внешние провайдеры добавляют опциональные слои воспоминаний. О том, как эта архитектура работает на практике, читайте в Система памяти агента Hermes — Как на самом деле работает постоянная память ИИ. Чтобы сравнить внешние бэкенды и компромиссы активации, см. Сравнение провайдеров памяти агентов — Honcho, Mem0, Hindsight и еще пять.

Команда	Описание
hermes memory setup	Интерактивная настройка внешнего провайдера памяти.
hermes memory status	Отображение активных настроек провайдера.
hermes memory off	Отключение внешнего провайдера; встроенные файлы остаются.

Когда провайдер активен, он может регистрировать дополнительные специфичные для провайдера подкоманды верхнего уровня — запустите hermes --help, чтобы увидеть, что подключено сегодня.

Шлюз мессенджинга, DM-паринг и платформы

Команда	Описание
hermes gateway setup	Интерактивная настройка платформы мессенджинга.
hermes gateway run	Шлюз на переднем плане (рекомендуется на WSL, Docker, Termux).
hermes gateway start | stop | restart | status	Управление службой systemd / launchd (--all влияет на шлюз каждого профиля).
hermes gateway install | uninstall	Установка или удаление фонового сервиса уровня пользователя.
hermes pairing list | approve | revoke | clear-pending	Согласования паринга DM для ботов мессенджинга.
hermes whatsapp	Поток паринга моста WhatsApp.
hermes slack manifest	Генерация манифеста приложения Slack с паритетом слэш-команд шлюза.

На WSL, hermes gateway run внутри tmux является устойчивым паттерном, когда gateway start работает некорректно.

Планировщик Cron, вебхуки и Kanban

Команда	Описание
hermes cron …	Создание, редактирование, пауза, возобновление, запуск, удаление запланированных промптов (tick для ручного прохождения планировщика).
hermes webhook subscribe, list, remove, test	Динамические маршруты вебхуков для событийно-ориентированных запусков.
hermes kanban …	Многопрофильная доска задач, подкрепленная SQLite; dispatch управляет воркерами.

hermes doctor, логи, резервное копирование и аналитика использования

Команда	Описание
hermes doctor [--fix]	Интерактивная диагностика и опциональный автоматический ремонт.
hermes status [--all] [--deep]	Лаконичный статус; более глубокие проверки при необходимости.
hermes dump [--show-keys]	Удобный для вставки сводный отчет о настройке для Discord или issues на GitHub.
hermes debug share	Загрузка отредактированного отладочного пакета на сервис для вставки (или --local).
hermes logs [agent | errors | gateway | list]	Tail и фильтрация логов в директории логов профиля.
hermes backup, hermes import	ZIP-снимки данных домашней директории и пути восстановления.
hermes insights [--days N] [--source …]	Аналитика токенов, стоимости и активности.

Когда что-то ломается после обновления, hermes doctor, hermes status и hermes logs errors -f формируют самый быстрый цикл сортировки.

MCP, ACP, веб-дашборд и миграция OpenClaw

Команда	Описание
hermes mcp serve	Запуск Hermes как сервера MCP.
hermes mcp add, remove, list, test, configure	Управление подключениями клиента MCP из Hermes.
hermes acp	Сервер stdio протокола Agent Client Protocol для редакторов (может потребоваться дополнительная установка).
hermes dashboard [--port …] [--host …]	Локальный веб-дашборд (pip install hermes-agent[web]).
hermes claw migrate …	Миграция конфигураций в стиле OpenClaw в Hermes (--dry-run, пресеты, опциональные секреты).

Миграция OpenClaw — hermes claw migrate читает устаревшие домашние директории OpenClaw; о том, как выглядел этот стек до перехода, см. Кейс-стади OpenClaw.

Слэш-команды в сессии CLI Hermes

Введите / для автодополнения. Команды не чувствительны к регистру; навыки регистрируют дополнительные маршруты /skill-name. Таблицы ниже являются отобранным подмножеством; полный реестр см. в Официальной документации Hermes Agent в конце этой статьи.

Поток сессии, фоновые задачи и цели

Команда	Описание
/new, /reset	Новый ID сессии и история.
/resume [name]	Возобновление именованной сессии.
/compress [focus]	Ручное сжатие контекста с опциональной темой фокуса.
/retry, /undo	Повтор последнего хода или отмена последнего обмена.
/title …	Именование сессии для последующего /resume.
/background …, /queue …, /steer …	Параллельный фоновый запуск, очередь следующего промпта, подталкивание в середине цикла после следующего инструмента.
/goal …	Постоянная многоходовая цель с циклом судьи (status, pause, resume, clear).
/branch, /fork	Разветвление разговора для альтернативного исследования.

Модели, переключатели инструментов, навыки и перезагрузка

Команда	Описание
/model … [--global]	Переключение моделей между настроенными провайдерами; --global сохраняет значение по умолчанию.
/tools …, /toolsets	Переключатели инструментов сессии и список наборов инструментов.
/skills …	Поиск, установка и управление навыками из чата.
/cron …	UI запланированных задач из сессии CLI.
/reload-mcp	Перезагрузка серверов MCP из конфигурации.
/reload	Перезагрузка .env в работающую сессию без перезапуска.

Использование, помощь и выход

Команда	Описание
/usage, /insights	Видимость токенов и стоимости; снимок аналитики.
/help, /quit	Помощь или выход из CLI.

Приложения мессенджинга (Telegram, Discord, Slack и другие) expose перекрывающийся набор слэш-команд плюс /approve, /restart, /commands и связанные вспомогательные средства, доступные только для шлюза — различия платформ документированы в справочнике по слэш-командам под разделом Официальная документация Hermes Agent ниже.

Полезные материалы для чтения

Связанные страницы на этом сайте (более широкий контекст для Hermes и терминальных агентов):

• Системы ИИ — Самохостинговые ассистенты, RAG и локальная инфраструктура — обзор кластера и как ассистенты вписываются в стек
• Память систем ИИ — центр памяти и смежные руководства
• Инструменты для разработчиков ИИ — ландшафт инструментов для терминала и IDE
• Быстрый старт OpenCode — еще один ориентированный на терминал агент для эргономичного сравнения

Официальная документация Hermes Agent

Исходная документация на hermes-agent.nousresearch.com:

• Hermes Agent
• Справочник по командам CLI
• Справочник по слэш-командам

---

Совет. Держите hermes dump и hermes doctor --fix в мышечной памяти — они превращают расплывчатые отчеты «что-то сломалось» в действенные диффы против известной рабочей настройки.