Справочник по командам профиля

На этой странице описаны все команды, относящиеся к профилям Hermes. Общие сведения о командах CLI см. в Справочнике команд CLI.

профиль Гермеса

hermes profile <subcommand>

Команда верхнего уровня для управления профилями. Запуск «профиля Гермеса» без подкоманды показывает помощь.

Подкоманда Описание
список Перечислите все профили.
использовать Установите активный профиль (по умолчанию).
создать Создайте новый профиль.
удалить Удалить профиль.
шоу Показать подробную информацию о профиле.
псевдоним Восстановите псевдоним оболочки для профиля.
переименовать Переименуйте профиль.
экспорт Экспортируйте профиль в архив tar.gz.
импорт Импортируйте профиль из архива tar.gz.
установить Установите дистрибутив профиля из URL-адреса git или локального каталога. См. Распространение профиля.
обновить Повторно извлеките профиль, управляемый распространением, и повторно примените его пакет.
информация Показать метаданные распространения для профиля (исходный URL, фиксация, последнее обновление).

список профилей Гермеса

hermes profile list

Перечисляет все профили. Активный в данный момент профиль отмечен знаком *.

Пример:

$ hermes profile list
  default
* work
  dev
  personal

Никаких вариантов.

использование профиля Hermes

hermes profile use <name>

Устанавливает <имя> в качестве активного профиля. Все последующие команды Hermes (без -p) будут использовать этот профиль.

Аргумент Описание
<имя> Имя профиля для активации. Используйте default для возврата к базовому профилю.

Пример:

hermes profile use work
hermes profile use default

создать профиль Гермеса

hermes profile create <name> [options]

Создает новый профиль.

Аргумент/Опция Описание
<имя> Имя нового профиля. Должно быть допустимое имя каталога (буквенно-цифровое, дефисы, подчеркивания).
--клон Скопируйте config.yaml, .env и SOUL.md из текущего профиля.
--клонировать-все Скопируйте все (конфигурацию, воспоминания, навыки, сеансы, состояние) из текущего профиля.
--clone-from <профиль> Клонировать из определенного профиля вместо текущего. Используется с --clone или --clone-all.
--no-alias Пропустить создание скрипта-обертки.

Создание профиля не не делает этот каталог профиля каталогом проекта/рабочей области по умолчанию для команд терминала. Если вы хотите, чтобы профиль запускался в конкретном проекте, установите terminal.cwd в config.yaml этого профиля.

Примеры:

# Blank profile — needs full setup
hermes profile create mybot

# Clone config only from current profile
hermes profile create work --clone

# Clone everything from current profile
hermes profile create backup --clone-all

# Clone config from a specific profile
hermes profile create work2 --clone --clone-from work

удалить профиль Гермеса

hermes profile delete <name> [options]

Удаляет профиль и удаляет его псевдоним оболочки.

Аргумент/Опция Описание
<имя> Профиль, который нужно удалить.
--да, -y Пропустить запрос подтверждения.

Пример:

hermes profile delete mybot
hermes profile delete mybot --yes
```:::предупреждение
При этом будет безвозвратно удален весь каталог профиля, включая все настройки, воспоминания, сеансы и навыки. Невозможно удалить текущий активный профиль.</div>
## `показ профиля Гермеса`
```bash
hermes profile show <name>

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

Это показывает домашний каталог Hermes профиля, а не рабочий каталог терминала. Команды терминала начинаются с terminal.cwd (или каталога запуска на локальном сервере, если cwd: ".").

Аргумент Описание
<имя> Профиль для проверки.

Пример:

$ hermes profile show work
Profile: work
Path:    ~/.hermes/profiles/work
Model:   anthropic/claude-sonnet-4 (anthropic)
Gateway: stopped
Skills:  12.env:    exists
SOUL.md: exists
Alias:   ~/.local/bin/work

псевдоним профиля Гермеса

hermes profile alias <name> [options]

Восстанавливает сценарий псевдонима оболочки в ~/.local/bin/<name>. Полезно, если псевдоним был случайно удален или вам нужно обновить его после перемещения установки Hermes.

Аргумент/Опция Описание
<имя> Профиль, для которого нужно создать/обновить псевдоним.
--удалить Удалите сценарий-оболочку вместо того, чтобы создавать его.
--name <псевдоним> Пользовательское имя псевдонима (по умолчанию: имя профиля).

Пример:

hermes profile alias work
# Creates/updates ~/.local/bin/work

hermes profile alias work --name mywork
# Creates ~/.local/bin/mywork

hermes profile alias work --remove
# Removes the wrapper script

переименование профиля Гермеса

hermes profile rename <old-name> <new-name>

Переименовывает профиль. Обновляет каталог и псевдоним оболочки.

Аргумент Описание
<старое имя> Текущее имя профиля.
<новое-имя> Новое имя профиля.

Пример:

hermes profile rename mybot assistant
# ~/.hermes/profiles/mybot → ~/.hermes/profiles/assistant
# ~/.local/bin/mybot → ~/.local/bin/assistant

экспорт профиля Hermes

hermes profile export <name> [options]

Экспортирует профиль в виде сжатого архива tar.gz.

Аргумент/Опция Описание
<имя> Профиль для экспорта.
-o, --output <путь> Путь к выходному файлу (по умолчанию: <имя>.tar.gz).

Пример:

hermes profile export work
# Creates work.tar.gz in the current directory

hermes profile export work -o./work-2026-03-29.tar.gz

импорт профиля Hermes

hermes profile import <archive> [options]

Импортирует профиль из архива tar.gz.

Аргумент/Опция Описание
<архив> Путь к архиву tar.gz для импорта.
--name <имя> Имя импортируемого профиля (по умолчанию: получено из архива).

Пример:

hermes profile import./work-2026-03-29.tar.gz
# Infers profile name from the archive

hermes profile import./work-2026-03-29.tar.gz --name work-restored

Команды распространения:::совет

Новичок в дистрибутивах? Начните с Руководства пользователя по профильным дистрибутивам — в нем подробно описано, почему, когда и как, с полными примерами. Разделы ниже представляют собой сухой справочник по CLI, если вы знаете, чего хотите.

Распространения превращают профиль в опубликованный артефакт с общими версиями. как git-репозиторий. Получатель устанавливает дистрибутив с помощью одного команду и может обновить ее позже, не затрагивая локальную воспоминания, сеансы или учетные данные.

auth.json и .env никогда не являются частью дистрибутива — они остаются в установка машины пользователя.

Пользовательские данные получателя (воспоминания, сеансы, авторизация, собственные правки в .env) всегда сохраняется при первоначальной установке и последующих обновления.:::информация «Экспорт профиля Гермеса» / «Импорт» по-прежнему являются правильными командами для локальное резервное копирование и восстановление профиля на вашем компьютере. Распространение (install/update/info) — это отдельная концепция: отправьте профиль через git, чтобы кто-то другой мог его установить.

установка профиля Hermes

hermes profile install <source> [--name <name>] [--alias] [--force] [--yes]

Устанавливает дистрибутив профиля из URL-адреса git или локального каталога.

Вариант Описание
<источник> URL-адрес Git (github.com/user/repo, https://..., git@..., ssh://, git://) или локальный каталог, содержащий distribution.yaml в его корне.
--имя ИМЯ Переопределить имя профиля из манифеста.
--псевдоним Также создайте оболочку-оболочку (например, telemetryhermes -p telemetry).
--force Перезапишите существующий профиль с таким же именем. Данные пользователя по-прежнему сохраняются.
-y, --да Пропустите запрос подтверждения предварительного просмотра манифеста.

Установщик показывает манифест, перечисляет необходимые переменные окружения и предупреждает о cron, прежде чем запрашивать подтверждение. Обязательные переменные окружения входят в Файл .env.EXAMPLE, который вы копируете в .env и заполняете.

Примеры:

# Install from a GitHub repo (shorthand)
hermes profile install github.com/kyle/telemetry-distribution --alias

# Install from a full HTTPS git URL
hermes profile install https://github.com/kyle/telemetry-distribution.git

# Install from SSH
hermes profile install git@github.com:kyle/telemetry-distribution.git

# Install from a local directory during development
hermes profile install./telemetry/

обновление профиля Гермеса

hermes profile update <name> [--force-config] [--yes]

Повторно клонирует дистрибутив из записанного источника и применяет обновления. Файлы, принадлежащие дистрибутиву (SOUL.md,kills/, cron/, mcp.json), перезаписано; пользовательские данные (память, сеансы, аутентификация,.env) никогда не затрагиваются.

config.yaml сохраняется по умолчанию, чтобы сохранить ваши локальные переопределения. Передайте --force-config, чтобы сбросить его до конфигурации, поставляемой в дистрибутиве.

информация о профиле Гермеса

hermes profile info <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`
hermes profile install git@github.com:your-org/internal-assistant.git

# Uses your git credential helper
hermes profile install https://github.com/your-org/internal-assistant.git

Если клон в интерактивном режиме запрашивает учетные данные на вашем терминале во время install, это приглашение проходит. Настройте свою авторизацию так, как вы обычно сначала используйте git clone для того же репозитория, а затем устанавливайте.

Манифест распространения (distribution.yaml)

Каждый дистрибутив имеет файл distribution.yaml в корне репозитория:

name: telemetry
version: 0.1.0
description: "Compliance monitoring harness"
hermes_requires: ">=0.12.0"
author: "Your Name"
license: "MIT"
env_requires:
  - name: OPENAI_API_KEY
    description: "OpenAI API key"
    required: true
  - name: GRAPHITI_MCP_URL
    description: "Memory graph URL"
    required: false
    default: "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:

  1. В каталоге вашего профиля создайте distribution.yaml как минимум с name. и «версия».
  2. Инициализируйте репозиторий git (или используйте существующий) и отправьте его на GitHub/ GitLab/любой хост, с которого Hermes может клонировать.
  3. Попросите получателей запустить hermes Profile install <your-repo-url>.

Используйте теги git для версий релизов — получатели, клонирующие HEAD, получат ваш последнее состояние, и вы всегда можете добавить version: в манифест.

hermes -p / hermes --profile

hermes -p <name> <command> [options]
hermes --profile <name> <command> [options]

Глобальный флаг для запуска любой команды Hermes в определенном профиле без изменения закрепленного значения по умолчанию. Это отменяет активный профиль на время выполнения команды.

Вариант Описание
-p <имя>, --profile <имя> Профиль, используемый для этой команды.

Примеры:

hermes -p work chat -q "Check the server status"
hermes --profile dev gateway start
hermes -p personal skills list
hermes -p work config edit

завершение Гермеса

hermes completion <shell>

Генерирует сценарии завершения оболочки. Включает дополнения для имен профилей и подкоманд профиля.

Аргумент Описание
<оболочка> Shell для генерации дополнений для: bash, zsh или fish.

Примеры:

# Install completions
hermes completion bash >> ~/.bashrc
hermes completion zsh >> ~/.zshrc
hermes completion fish > ~/.config/fish/completions/hermes.fish

# Reload shell
source ~/.bashrc

После установки завершение табуляции работает для: - hermes Profile <TAB> — подкоманды (список, использование, создание и т.д.) - hermes Profile use <TAB> — имена профилей - hermes -p <TAB> — имена профилей

См. также