Шпаргалка по CLI-агенту Hermes: команды, флаги и слэш-команды
Команды Shell и TUI для self-hosted Hermes Agent.
Hermes Agent от Nous Research — это ассистент с использованием инструментов, не зависящий от конкретной модели, который можно запускать локально или на VPS, из командной строки, в полноэкранном TUI или через шлюз мессенджеров.
Hermes не привязывает вас к одному интерфейсу. Вы можете использовать:
- классический CLI
hermes/hermes chat, - полноэкранную сессию
hermes --tui, - долгоживущий
hermes gatewayдля Telegram, Discord, Slack и других платформ сообщений, hermes dashboardдля локального браузерного интерфейса (при установленном модуле web).
Все эти режимы разделяют одни и те же конфигурацию и данные в директории ~/.hermes; на этой странице перечислены команды командной строки, которые важны для всех этих режимов.
Ниже приведен плотный справочник команд, сгруппированный по задачам и сверенный с официальным справочником команд CLI от 6 октября 2026 года. На эту дату последней стабильной версией была v0.21.5 (v2026.9.24).
Установка 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] |
Получение последней версии кода, повторная установка зависимостей, необязательный снимок домашней директории перед обновлением или перезапуск шлюза. |
hermes uninstall [--full] [--yes] |
Удаление Hermes; необязательное полное удаление данных. |
Нативная поддержка Windows отсутствует; используйте WSL2. Установка на Android через Termux следует отдельному сценарию, описанному в документации upstream.
Глобальные флаги для каждого вызова 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 "..." |
В TTY отправляет промпт как первый ход и оставается в сессии. До версии 0.21 программа выходила после одного ответа. |
hermes chat --oneshot -q "..." |
Ответ и выход (старое поведение -q). Имплицируется флагом -Q и для non-TTY stdio. Используйте это, когда вам нужен вывод инструментов в транскрипте. |
hermes chat --query-file PATH |
Чтение промпта из файла или из stdin (через -). Shell не интерпретирует содержимое. Взаимоисключаемо с -q. |
hermes -z "..." |
Скриптовый одноразовый запуск — только финальный ответ в stdout, без баннера или шума сессии. Тот же агент и инструменты; лучший вариант для pipes и скриптов. |
hermes -z "…" --usage-file PATH |
После запуска -z записать JSON-отчет об использовании (токены, стоимость, completed / failed / partial), даже если запуск завершился ошибкой. |
hermes chat -q "…" --format stream-json |
JSONL-события в stdout (system, text, tool_use, tool_result, result). Имплицирует тихий режим; отклоняет --tui. |
hermes chat --quiet, -Q |
Более тихий программный режим (баннер и превью инструментов подавлены). Также имплицирует oneshot при сочетании с -q. |
-m / --model, --provider |
Переопределение модели и провайдера для конкретного запуска; переменные окружения HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER зеркалят это поведение. |
-t / --toolsets |
Включение наборов инструментов (через запятую) для запуска. |
-s / --skills |
Предварительная загрузка навыков (повторяемый флаг или через запятую). |
--image path |
Прикрепление локального изображения к одному запросу. |
--checkpoints |
Включение контрольных точек файловой системы перед деструктивными правками. |
--max-turns N |
Ограничение итераций вызова инструментов на ход (по умолчанию 500, или agent.max_turns в конфиге). |
--safe-mode |
Отключение пользовательской конфигурации, правил, памяти, плагинов, shell-хуков и MCP. Имплицирует --ignore-user-config и --ignore-rules. |
--source |
Тег источника сессии (cli против tool для интеграций). Одноразовые запуски по умолчанию имеют тег oneshot. |
Выбор модели Hermes вне сессии против /model внутри сессии — Запуск hermes model из shell — это место, где вы добавляете провайдеров, ключи и OAuth. Слеш-команда /model переключает только между уже настроенными провайдерами. Если в /model вы видите только OpenRouter, выйдите из сессии и завершите настройку через hermes model.
Коды завершения. Запуск chat --oneshot / -Q завершается кодом 0, если ход выполнен успешно, 1, если он завершился ошибкой, прерван по пути, исчерпан бюджет итераций или не начался, и 130 при прерывании (interrupt). hermes -z использует другую схему: 0 — выполнено, 2 — ошибка или частичное выполнение (даже если было выведено объяснение), 1 — если выполненный ход не вывел текст, 130 при прерывании. Оценивайте конвейер по коду, а не по тому, пустой ли stdout.
Выбор модели, пулы учетных данных и провайдеры резервирования
| Команда | Описание |
|---|---|
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 setup --portal |
Одноразовый вход в Nous Portal: OAuth, настройка Nous как провайдера инференса, подключение к Tool Gateway. |
hermes portal [status | open | tools] |
Состояние аутентификации Portal и маршрутизация Tool Gateway. Без подкоманды выполняется status. |
hermes login был удален. Используйте hermes auth для OAuth и пулов учетных данных, hermes model для выбора провайдера или hermes setup для полного мастера. hermes auth logout <provider> очищает сохраненные учетные данные.
Выбор локальных 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 |
Короткие wrapper-скрипты для быстрой смены профилей. |
hermes worktree list |
Аудит черновых worktree: возраст, размер и можно ли их безопасно удалить. --json для скриптов. |
hermes worktree prune |
Удаление чистых, смерженных черновых деревьев. --dry-run печатает план; --older-than N сужает выборку. Деревья с незакоммиченной работой или уникальными коммитами сохраняются. |
Используйте hermes -p work chat -q "..." для одноразовых запусков без изменения «липкого» профиля по умолчанию. В TTY это остается в сессии; добавьте --oneshot, если запуск профиля должен завершиться.
Хаб навыков, наборы инструментов, 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, чтобы увидеть, что подключено сегодня.
Шлюз мессенджеров, привязка DM и платформы
| Команда | Описание |
|---|---|
hermes gateway setup |
Интерактивная настройка платформы мессенджеров. |
hermes gateway run |
Шлюз в переднем плане (рекомендуется для WSL, Docker, Termux). |
hermes gateway start | stop | restart | status |
Управление сервисом systemd / launchd (--all влияет на шлюз каждого профиля). |
hermes gateway install | uninstall |
Установка или удаление пользовательского фоновой сервиса. |
hermes gateway migrate [--dry-run] |
Объединение профилей-шлюзов в один хост-шлюз. hermes update выполняет это, если preflight не блокирует. Обратного отката --standalone нет. |
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 на self-hosted шлюзах, смотрите 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 |
Загрузка отредактированного отладочного бандля на сервис вставки (или --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 |
Агентный клиентский протокол (Agent Client Protocol) stdio-сервер для редакторов (может потребовать доп. установку). |
hermes dashboard [--port …] [--host …] |
Локальный веб-дашборд (pip install hermes-agent[web]). |
hermes claw migrate … |
Миграция конфигураций в стиле OpenClaw в Hermes (--dry-run, пресеты, необязательные секреты). |
hermes import-agent [claude-code | codex] |
Импорт настройки Claude Code (~/.claude) или Codex CLI (~/.codex). Всегда предварительный просмотр; API-ключи никогда не копируются. --sync повторно импортирует источники, файлы которых изменились. |
Миграция с OpenClaw — hermes claw migrate читает легаси-директории OpenClaw; полный пошаговый переход, включая dry-run проверку, политику конфликтов, обработку секретов и передачу каналов, описан в Как безопасно мигрировать с OpenClaw на Hermes Agent. Для понимания того, как выглядел этот стек до перехода, смотрите Кейс-стади OpenClaw.
Слеш-команды в сессии Hermes CLI
Введите / для автодополнения. Команды регистронезависимы; навыки регистрируют дополнительные маршруты /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 |
Ветвление разговора для альтернативного исследования. |
/btw … |
Боковой вопрос о текущем разговоре; не прерывает основной ход. |
/context [all] |
Разбивка использования контекста. all добавляет затраты на навыки и наборы инструментов. |
/status |
Информация о сессии плюс локальная сводка (последние ходы, инструменты, файлы). Без вызова модели. |
/sessions |
Выбор внутри сессии: фильтр, стрелки, Enter для возобновления. |
Модели, переключатели инструментов, навыки и перезагрузка
| Команда | Описание |
|---|---|
/model … [--global] |
Переключение моделей между настроенными провайдерами; --global персистит значение по умолчанию. |
/tools …, /toolsets |
Переключатели инструментов сессии и список наборов инструментов. |
/skills … |
Поиск, установка и управление навыками из чата. |
/cron … |
UI запланированных задач из сессии CLI. |
/reload-mcp |
Перезагрузка MCP-серверов из конфигурации. |
/reload |
Перезагрузка .env в работающей сессии без рестарта. |
Использование, помощь и выход
| Команда | Описание |
|---|---|
/usage, /insights |
Видимость токенов и стоимости; снимок аналитики. |
/voice on, /voice tts |
Голосовая запись в CLI (по умолчанию Ctrl+B) и воспроизведение вслух. |
/reasoning high |
Повышение усилий рассуждения для сессии. |
/help, /quit |
Помощь или выход из CLI. |
Строка, начинающаяся с !, выполняется в хост-оболочке без хода модели (!git status). Она не попадает в разговор, и опасные команды все равно вызывают запрос подтверждения. Ctrl+S сохраняет черновик композера только для сессии; ничего не записывается на диск.
Мессенджеры (Telegram, Discord, Slack и другие) предоставляют пересекающийся набор слеш-команд, а также /approve, /restart, /commands и связанные хелперы, доступные только в шлюзе — различия между платформами документированы в справочнике слеш-команд под Официальная документация Hermes Agent ниже.
Полезное чтение
Связанные страницы на этом сайте:
- AI Systems — Self-hosted ассистенты, RAG и локальная инфраструктура — обзор кластера и как ассистенты вписываются в стек
- Память AI Systems — хаб памяти и смежные руководства
Официальная документация Hermes Agent
Документация upstream на hermes-agent.nousresearch.com:
Совет. Держите hermes dump и hermes doctor --fix в мыслечувстве — они превращают расплывчатые отчеты «что-то сломалось» в конкретные диффы относительно известной рабочей конфигурации.
