Шпаргалка по CLI агента Hermes: команды, флаги и слэш-шоркаты

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	Генерация сценариев автодополнения для shell.
hermes update [--check] [--backup] [--restart-gateway]	Получение последней версии кода, повторная установка зависимостей, опциональный снимок каталога перед обновлением или перезапуск 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 или tool для интеграций).

Модель Hermes вне сессии vs /model внутри нее — Запуск hermes model из shell — это то место, где вы добавляете провайдеров, ключи и 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 (задержка, стоимость, операционная поддержка).

Когда ваша модель по умолчанию завершается на 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	Вывод путей к файлам конфигурации и env.
hermes config check	Обнаружение отсутствующих или устаревших настроек.
hermes config migrate	Интерактивное применение новых параметров.

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

Управление сессиями и 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 "..." для спонтанных запусков без изменения зафиксированного профиля по умолчанию.

Хаб навыков, наборы инструментов, shell-хуки и плагины

Для профильно-ориентированной конфигурации и навыков, настроенных под реальные производственные рабочие процессы по ролям, смотрите Навыки Hermes AI Assistant для реальных производственных сборок. Для создания и отладки файлов 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	Заявленные shell-хуки и списки разрешенных команд в конфигурации.
hermes plugins	Композитный UI или подкоманды для установки, включения, отключения и удаления плагинов.

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

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

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

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

Gateway обмена сообщениями, парное соединение DM и платформы

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

На WSL запуск hermes gateway run внутри tmux — устойчивая модель, когда gateway start ведет себя нестабильно. Для сквозных рабочих процессов со смартфоном с использованием этого же слоя gateway смотрите Голосовое управление Hermes с вашего телефона. Для работы на выделенном сервере с отдельным настольным клиентом следуйте инструкции Безголовый сервер Hermes Agent и настройка удаленного рабочего стола.

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

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

Если вам нужны практические паттерны конкурентности для hermes kanban на self-hosted gateway, смотрите Kanban в Hermes Agent для Self-Hosted LLM рабочих процессов.

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

Команда	Описание
hermes doctor [--fix]	Интерактивная диагностика и опциональный автоматический ремонт.
hermes status [--all] [--deep]	Краткий статус; более глубокие проверки при необходимости.
hermes dump [--show-keys]	Дружественный для копирования сводный отчет для Discord или GitHub issues.
hermes debug share	Загрузка отредактированного отладочного пакета на paste-сервис (или --local).
hermes logs [agent | errors | gateway | list]	Просмотр и фильтрация логов в каталоге логов профиля.
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; полный поэтапный переход, включая просмотр dry-run, политику конфликтов, обработку секретов и передачу каналов, описан в Как безопасно смигрировать из OpenClaw в Hermes Agent. Чтобы узнать, как выглядела эта стек-система до миграции, смотрите кейс OpenClaw.

Slash-команды в сессии 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 …	Интерфейс запланированных задач из сессии CLI.
/reload-mcp	Перезагрузка MCP-серверов из конфигурации.
/reload	Перезагрузка .env в работающей сессии без перезапуска.

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

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

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

Полезное чтение

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

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

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

Документация разработчиков на hermes-agent.nousresearch.com:

• Hermes Agent
• Справочник CLI команд
• Справочник slash-команд

---

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