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

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

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

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

Все эти варианты используют одни и те же конфигурацию и данные в директории ~/.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, наборов инструментов, возобновления, worktree, чекпоинтов.
hermes chat -q "..."	Одноразовый промпт (неинтерактивный); сохраняет более богатый вывод, чем -z, когда работают инструменты.
hermes -z "..."	Скриптовый одноразовый запуск — только финальный ответ в stdout, без баннеров и шума сеанса. Тот же агент и инструменты; идеально для пайпов и скриптов.
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 переключает только между уже настроенными провайдерами. Если вы видите только OpenRouter в /model, выйдите из сеанса и завершите настройку через 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 (задержка, стоимость, операционные расходы).

Как только ваш провайдер по умолчанию использует Qwen или Gemma на чем-то вроде Ollama, значения по умолчанию сэмплера важны не меньше, чем ID модели, который вы ввели; сводные пресеты температуры и штрафов для агентного инференса см. в Параметры агентного инференса LLM для Qwen и Gemma.

Файлы конфигурации и команды 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	Архивация или восстановление профиля в виде tarball.
hermes profile alias	Короткие обертки-скрипты для быстрого переключения профилей.

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

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

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

Команда	Описание
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 остаются активными; внешние провайдеры добавляют опциональные слои recall. Чтобы узнать, как эта архитектура работает на практике, прочитайте Система памяти агента 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 ведет себя некорректно. Для сквозных рабочих процессов с телефоном, использующих тот же слой шлюза, см. Голосовое управление Hermes с вашего телефона. Для работы на выделенном сервере с отдельным настольным клиентом следуйте руководству Настройка безголовый сервера Hermes Agent и удаленного рабочего стола.

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

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

Если вам нужны практические паттерны конкурентности для hermes kanban на самодостаточных шлюзах, см. Kanban в Hermes Agent для самодостаточных рабочих процессов LLM.

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

Команда	Описание
hermes doctor [--fix]	Интерактивная диагностика и опциональный автоматический ремонт.
hermes status [--all] [--deep]	Краткий статус; более глубокие проверки при необходимости.
hermes dump [--show-keys]	Удобная для вставки сводка настройки для Discord или GitHub issues.
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 и другие) экспонируют перекрывающийся набор слэш-команд, а также /approve, /restart, /commands и связанные с шлюзом помощники — различия платформ документированы в справочнике по слэш-командам под разделом Официальная документация Hermes Agent ниже.

Дополнительная полезная литература

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

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

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

Документация upstream на hermes-agent.nousresearch.com:

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

---

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