Команда верхнего уровня для управления профилями. Запуск «профиля Гермеса» без подкоманды показывает помощь.
Подкоманда
Описание
список
Перечислите все профили.
использовать
Установите активный профиль (по умолчанию).
создать
Создайте новый профиль.
удалить
Удалить профиль.
шоу
Показать подробную информацию о профиле.
псевдоним
Восстановите псевдоним оболочки для профиля.
переименовать
Переименуйте профиль.
экспорт
Экспортируйте профиль в архив tar.gz.
импорт
Импортируйте профиль из архива tar.gz.
установить
Установите дистрибутив профиля из URL-адреса git или локального каталога. См. Распространение профиля.
обновить
Повторно извлеките профиль, управляемый распространением, и повторно примените его пакет.
информация
Показать метаданные распространения для профиля (исходный URL, фиксация, последнее обновление).
список профилей Гермеса
hermesprofilelist
Перечисляет все профили. Активный в данный момент профиль отмечен знаком *.
Пример:
$hermesprofilelist
default
*work
dev
personal
Никаких вариантов.
использование профиля Hermes
hermesprofileuse<name>
Устанавливает <имя> в качестве активного профиля. Все последующие команды Hermes (без -p) будут использовать этот профиль.
Аргумент
Описание
<имя>
Имя профиля для активации. Используйте default для возврата к базовому профилю.
Пример:
hermesprofileusework
hermesprofileusedefault
создать профиль Гермеса
hermesprofilecreate<name>[options]
Создает новый профиль.
Аргумент/Опция
Описание
<имя>
Имя нового профиля. Должно быть допустимое имя каталога (буквенно-цифровое, дефисы, подчеркивания).
--клон
Скопируйте config.yaml, .env и SOUL.md из текущего профиля.
--клонировать-все
Скопируйте все (конфигурацию, воспоминания, навыки, сеансы, состояние) из текущего профиля.
--clone-from <профиль>
Клонировать из определенного профиля вместо текущего. Используется с --clone или --clone-all.
--no-alias
Пропустить создание скрипта-обертки.
Создание профиля не не делает этот каталог профиля каталогом проекта/рабочей области по умолчанию для команд терминала. Если вы хотите, чтобы профиль запускался в конкретном проекте, установите terminal.cwd в config.yaml этого профиля.
Примеры:
# Blank profile — needs full setup
hermesprofilecreatemybot
# Clone config only from current profile
hermesprofilecreatework--clone
# Clone everything from current profile
hermesprofilecreatebackup--clone-all
# Clone config from a specific profile
hermesprofilecreatework2--clone--clone-fromwork
Отображает сведения о профиле, включая его домашний каталог, настроенную модель, состояние шлюза, количество навыков и состояние файла конфигурации.
Это показывает домашний каталог Hermes профиля, а не рабочий каталог терминала. Команды терминала начинаются с terminal.cwd (или каталога запуска на локальном сервере, если cwd: ".").
Восстанавливает сценарий псевдонима оболочки в ~/.local/bin/<name>. Полезно, если псевдоним был случайно удален или вам нужно обновить его после перемещения установки Hermes.
Аргумент/Опция
Описание
<имя>
Профиль, для которого нужно создать/обновить псевдоним.
--удалить
Удалите сценарий-оболочку вместо того, чтобы создавать его.
--name <псевдоним>
Пользовательское имя псевдонима (по умолчанию: имя профиля).
Экспортирует профиль в виде сжатого архива tar.gz.
Аргумент/Опция
Описание
<имя>
Профиль для экспорта.
-o, --output <путь>
Путь к выходному файлу (по умолчанию: <имя>.tar.gz).
Пример:
hermesprofileexportwork
# Creates work.tar.gz in the current directory
hermesprofileexportwork-o./work-2026-03-29.tar.gz
импорт профиля Hermes
hermesprofileimport<archive>[options]
Импортирует профиль из архива tar.gz.
Аргумент/Опция
Описание
<архив>
Путь к архиву tar.gz для импорта.
--name <имя>
Имя импортируемого профиля (по умолчанию: получено из архива).
Пример:
hermesprofileimport./work-2026-03-29.tar.gz
# Infers profile name from the archive
hermesprofileimport./work-2026-03-29.tar.gz--namework-restored
Команды распространения:::совет
Новичок в дистрибутивах? Начните с Руководства пользователя по профильным дистрибутивам — в нем подробно описано, почему, когда и как, с полными примерами. Разделы ниже представляют собой сухой справочник по CLI, если вы знаете, чего хотите.
Распространения превращают профиль в опубликованный артефакт с общими версиями.
как git-репозиторий. Получатель устанавливает дистрибутив с помощью одного
команду и может обновить ее позже, не затрагивая локальную
воспоминания, сеансы или учетные данные.
auth.json и .env никогда не являются частью дистрибутива — они остаются в
установка машины пользователя.
Пользовательские данные получателя (воспоминания, сеансы, авторизация, собственные правки в
.env) всегда сохраняется при первоначальной установке и последующих
обновления.:::информация
«Экспорт профиля Гермеса» / «Импорт» по-прежнему являются правильными командами для
локальное резервное копирование и восстановление профиля на вашем компьютере. Распространение
(install/update/info) — это отдельная концепция: отправьте профиль через
git, чтобы кто-то другой мог его установить.
Установщик показывает манифест, перечисляет необходимые переменные окружения и предупреждает о
cron, прежде чем запрашивать подтверждение. Обязательные переменные окружения входят в
Файл .env.EXAMPLE, который вы копируете в .env и заполняете.
Примеры:
# Install from a GitHub repo (shorthand)
hermesprofileinstallgithub.com/kyle/telemetry-distribution--alias
# Install from a full HTTPS git URL
hermesprofileinstallhttps://github.com/kyle/telemetry-distribution.git
# Install from SSH
hermesprofileinstallgit@github.com:kyle/telemetry-distribution.git
# Install from a local directory during development
hermesprofileinstall./telemetry/
обновление профиля Гермеса
hermesprofileupdate<name>[--force-config][--yes]
Повторно клонирует дистрибутив из записанного источника и применяет обновления.
Файлы, принадлежащие дистрибутиву (SOUL.md,kills/, cron/, mcp.json),
перезаписано; пользовательские данные (память, сеансы, аутентификация,.env) никогда не затрагиваются.
config.yaml сохраняется по умолчанию, чтобы сохранить ваши локальные переопределения.
Передайте --force-config, чтобы сбросить его до конфигурации, поставляемой в дистрибутиве.
информация о профиле Гермеса
hermesprofileinfo<name>
Печатает манифест распространения профиля — имя, версия, обязательно.
Версия Hermes, автор, требования к переменной окружения, исходный URL/путь и
временная метка Installed:, записанная при последней раздаче
install-ed или update-d. Полезно для проверки общего профиля.
необходимо перед его установкой и для обнаружения «данный профиль был установлен
6 месяцев назад и не обновлялось».
Список профилей Hermes также показывает имя и версию дистрибутива в
столбец «Распространение» и «профиль Hermes показать <имя>» / «удалить <имя>»
отображать исходный URL-адрес, чтобы вы могли сразу определить, какие профили пришли
из репозитория git или были созданы локально.
Частные раздачи
Частный репозиторий git работает как источник распространения без каких-либо дополнительных действий.
конфигурация — установочная оболочка записывается в ваш обычный двоичный файл git, поэтому
какая бы аутентификация ни была настроена в вашей оболочке (ключ SSH,
применяется помощник git credential, сохраняются учетные данные HTTPS в GitHub CLI).
прозрачно.
# Uses your SSH key, the same as any other `git clone`
hermesprofileinstallgit@github.com:your-org/internal-assistant.git
# Uses your git credential helper
hermesprofileinstallhttps://github.com/your-org/internal-assistant.git
Если клон в интерактивном режиме запрашивает учетные данные на вашем терминале во время
install, это приглашение проходит. Настройте свою авторизацию так, как вы
обычно сначала используйте git clone для того же репозитория, а затем устанавливайте.
Манифест распространения (distribution.yaml)
Каждый дистрибутив имеет файл distribution.yaml в корне репозитория:
name:telemetryversion:0.1.0description:"Compliancemonitoringharness"hermes_requires:">=0.12.0"author:"YourName"license:"MIT"env_requires:-name:OPENAI_API_KEYdescription:"OpenAIAPIkey"required:true-name:GRAPHITI_MCP_URLdescription:"MemorygraphURL"required:falsedefault:"http://127.0.0.1:8000/sse"distribution_owned:# optional; defaults to SOUL.md, config.yaml,# mcp.json, skills/, cron/, distribution.yaml-SOUL.md-skills/compliance/-cron/
hermes_requires поддерживает >=, <=, ==, !=, >, < или
версия (трактуется как >=). Установка завершается с явной ошибкой, если текущий
Версия Hermes не соответствует спецификации.
distribution_owned не является обязательным. Если установлено, заменяются только эти пути.
обновление; все остальное в профиле остается собственностью пользователя. Если опущено,
применяются значения по умолчанию, указанные выше.
Публикация дистрибутива
Создание дистрибутива — это просто нажатие git:
В каталоге вашего профиля создайте distribution.yaml как минимум с name.
и «версия».
Инициализируйте репозиторий git (или используйте существующий) и отправьте его на GitHub/
GitLab/любой хост, с которого Hermes может клонировать.
Используйте теги git для версий релизов — получатели, клонирующие HEAD, получат ваш
последнее состояние, и вы всегда можете добавить version: в манифест.
Глобальный флаг для запуска любой команды Hermes в определенном профиле без изменения закрепленного значения по умолчанию. Это отменяет активный профиль на время выполнения команды.
Вариант
Описание
-p <имя>, --profile <имя>
Профиль, используемый для этой команды.
Примеры:
hermes-pworkchat-q"Check the server status"
hermes--profiledevgatewaystart
hermes-ppersonalskillslist
hermes-pworkconfigedit
завершение Гермеса
hermescompletion<shell>
Генерирует сценарии завершения оболочки. Включает дополнения для имен профилей и подкоманд профиля.
Аргумент
Описание
<оболочка>
Shell для генерации дополнений для: bash, zsh или fish.
После установки завершение табуляции работает для:
- hermes Profile <TAB> — подкоманды (список, использование, создание и т.д.)
- hermes Profile use <TAB> — имена профилей
- hermes -p <TAB> — имена профилей