profile-commands

anchor alias

프로필 명령 참조

이 페이지에서는 Hermes 프로필과 관련된 모든 명령을 다룹니다. 일반적인 CLI 명령은 CLI 명령 참조를 참조하세요.

`hermes profile`

hermes profile <subcommand>

프로필 관리를 위한 최상위 명령입니다. 하위 명령 없이 hermes profile을 실행하면 도움말이 표시됩니다.

하위 명령	설명
`list`	모든 프로필을 나열합니다.
`use`	활성(기본) 프로필을 설정합니다.
`create`	새 프로필을 만듭니다.
`delete`	프로필을 삭제합니다.
`show`	프로필에 대한 자세히 보기를 표시합니다.
`alias`	프로필의 셸 별칭을 다시 생성합니다.
`rename`	프로필 이름을 바꿉니다.
`export`	프로필을 tar.gz 아카이브로 내보냅니다.
`import`	tar.gz 아카이브에서 프로필을 가져옵니다.
`install`	git URL 또는 로컬 디렉터리에서 프로필 배포를 설치합니다. 프로필 배포를 참조하세요.
`update`	배포 관리 프로필을 다시 가져오고 해당 번들을 다시 적용합니다.
`info`	프로필의 배포 메타데이터(원본 URL, 커밋, 마지막 업데이트)를 표시합니다.

`hermes profile list`

hermes profile list

모든 프로필을 나열합니다. 현재 활성 프로필은 *으로 표시됩니다.

예:

$ hermes profile list
  default
* work
  dev
  personal

옵션이 없습니다.

`hermes profile use`

hermes profile use <name>
``&lt;name&gt;`을 활성 프로필로 설정합니다. 모든 후속 `hermes` 명령(`-p` 제외)은 이 프로필을 사용합니다.

| 인수 | 설명 |
|----------|-------------|
| `&lt;name&gt;` | 활성화할 프로필 이름입니다. 기본 프로필로 돌아가려면 `default`을 사용하세요. |

**예:**

```bash
hermes profile use work
hermes profile use default

`hermes profile create`

hermes profile create &lt;name&gt; [options]

새 프로필을 만듭니다.

인수/옵션	설명
`<name>`	새 프로필의 이름입니다. 유효한 디렉터리 이름(영숫자, 하이픈, 밑줄)이어야 합니다.
`--clone`	현재 프로필에서 `config.yaml`, `.env` 및 `SOUL.md`을 복사합니다.
`--clone-all`	현재 프로필에서 모든 항목(구성, 메모리, 기술, 세션, 상태)을 복사합니다.
`--clone-from <profile>`	현재 프로필 대신 특정 프로필에서 복제합니다. `--clone` 또는 `--clone-all`과 함께 사용됩니다.
`--no-alias`	래퍼 스크립트 생성을 건너뜁니다.

프로필을 생성한다고 해서 해당 프로필 디렉터리가 터미널 명령에 대한 기본 프로젝트/작업 공간 디렉터리로 만들어지는 것은 아닙니다. 특정 프로젝트에서 프로필을 시작하려면 해당 프로필의 config.yaml에 terminal.cwd을 설정하세요.

예:

# 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`

hermes profile delete &lt;name&gt; [options]

프로필을 삭제하고 해당 셸 별칭을 제거합니다.

인수/옵션	설명
`<name>`	삭제할 프로필입니다.
`--yes`, `-y`	확인 메시지를 건너뜁니다.

예:

hermes profile delete mybot
hermes profile delete mybot --yes

경고

이렇게 하면 모든 구성, 메모리, 세션 및 기술을 포함하여 프로필의 전체 디렉터리가 영구적으로 삭제됩니다. 현재 활성 프로필을 삭제할 수 없습니다.

`hermes profile show`

hermes profile show &lt;name&gt;

홈 디렉터리, 구성된 모델, 게이트웨이 상태, 기술 수 및 구성 파일 상태를 포함하여 프로필에 대한 세부 정보를 표시합니다.

이는 터미널 작업 디렉터리가 아닌 프로필의 Hermes 홈 디렉터리를 표시합니다. 터미널 명령은 terminal.cwd(또는 cwd: "."인 경우 로컬 백엔드의 실행 디렉터리)에서 시작됩니다.

인수	설명
`<name>`	검사할 프로필입니다.

예:

$ 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`

hermes profile alias &lt;name&gt; [options]
``~/.local/bin/&lt;name&gt;`에서 쉘 별칭 스크립트를 다시 생성합니다. 별칭이 실수로 삭제되었거나 Hermes 설치를 이동한 후 업데이트해야 하는 경우 유용합니다.

| 인수/옵션 | 설명 |
|-------------------|-------------|
| `&lt;name&gt;` | 별칭을 생성/업데이트할 프로필입니다. |
| `--remove` | 래퍼 스크립트를 만드는 대신 제거하세요. |
| `--name &lt;alias&gt;` | 사용자 정의 별칭 이름(기본값: 프로필 이름) |

**예:**

```bash
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`

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

프로필의 이름을 바꿉니다. 디렉터리 및 셸 별칭을 업데이트합니다.

인수	설명
`<old-name>`	현재 프로필 이름.
`<new-name>`	새 프로필 이름.

예:

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

`hermes profile export`

hermes profile export <name> [options]

프로필을 압축된 tar.gz 아카이브로 내보냅니다.

인수/옵션	설명
`<name>`	내보낼 프로필입니다.
`-o`, `--output <path>`	출력 파일 경로(기본값: `<name>.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 profile import`

hermes profile import <archive> [options]

tar.gz 아카이브에서 프로필을 가져옵니다.

인수/옵션	설명
`<archive>`	가져올 tar.gz 아카이브의 경로입니다.
`--name <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

배포 명령

{#hermes-profile-alias}

배포판을 처음 사용하시나요? 프로필 배포 사용자 가이드로 시작하세요. 전체 예제를 통해 이유, 시기, 방법을 다룹니다. 아래 섹션은 원하는 것이 무엇인지 알고 있는 경우를 위한 건식 CLI 참조입니다.

배포판은 프로필을 공유 가능하고 버전이 지정된 아티팩트로 전환합니다. git 저장소로. 수신자는 단일 배포판을 설치합니다. 명령을 내리고 나중에 로컬을 건드리지 않고도 업데이트할 수 있습니다. 추억, 세션 또는 자격 증명.

auth.json 및 .env은 배포판의 일부가 아닙니다. 사용자 컴퓨터를 설치하는 중입니다.

수신자의 사용자 데이터(메모리, 세션, 인증, 자신이 편집한 내용) .env)은 초기 설치와 이후 설치 전체에서 항상 보존됩니다. 업데이트.

정보

hermes profile export / import은 여전히 적합한 명령입니다. 자신의 컴퓨터에 있는 프로필의 로컬 백업 및 복원. 분포 (install / update / info)은 별도의 개념입니다. 다음을 통해 프로필을 배송하세요. git을 사용하면 다른 사람이 설치할 수 있습니다.

`hermes profile install`

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

git URL 또는 로컬 디렉터리에서 프로필 배포를 설치합니다.

옵션	설명
`<source>`	Git URL(`github.com/user/repo`, `https://...`, `git@...`, `ssh://`, `git://`) 또는 루트에 `distribution.yaml`이 포함된 로컬 디렉터리.
`--name NAME`	매니페스트에서 프로필 이름을 재정의합니다.
`--alias`	또한 셸 래퍼를 만듭니다(예: `telemetry` → `hermes -p telemetry`).
`--force`	동일한 이름의 기존 프로필을 덮어씁니다. 사용자 데이터는 계속 보존됩니다.
`-y`, `--yes`	매니페스트 미리보기 확인 메시지를 건너뜁니다.

설치 프로그램은 매니페스트를 표시하고 필요한 환경 변수를 나열하며 다음 사항에 대해 경고합니다. 확인을 요청하기 전에 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`

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

기록된 소스에서 배포를 다시 복제하고 업데이트를 적용합니다. 배포판 소유 파일(SOUL.md, Skill/, cron/, mcp.json)은 덮어쓰다; 사용자 데이터(메모리, 세션, 인증,.env)는 절대 건드리지 않습니다.

config.yaml은 로컬 재정의를 유지하기 위해 기본적으로 보존됩니다. --force-config을 전달하여 배포판의 제공된 구성으로 재설정합니다.

`hermes profile info`

hermes profile info <name>

프로필의 배포 매니페스트(이름, 버전, 필수)를 인쇄합니다. Hermes 버전, 작성자, 환경 변수 요구 사항, 소스 URL/경로 및 배포가 마지막으로 수행되었을 때 기록된 Installed: 타임스탬프 install-ed 또는 update-d. 공유된 프로필이 무엇인지 확인하는 데 유용합니다. 설치하기 전에 필요하며 "이 프로필이 설치되었습니다"를 확인하기 위해 6개월 전인데 업데이트가 안 됐어요."

hermes profile list은 배포 이름과 버전도 표시합니다. Distribution 열 및 hermes profile show <name> / delete <name> 어떤 프로필이 왔는지 한눈에 알 수 있도록 소스 URL을 표시합니다. git repo에서 vs. 로컬에서 생성되었습니다.

비공개 배포

개인 Git 저장소는 추가 작업 없이 배포 소스로 작동합니다. 구성 — 설치 쉘은 일반 git 바이너리로 이루어지므로 쉘에 이미 설정된 인증(SSH 키, git credential 도우미, GitHub CLI에 저장된 HTTPS 자격 증명) 적용 투명하게.

# 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

복제 중에 터미널에서 대화형으로 자격 증명을 묻는 메시지가 표시되는 경우 설치하면 해당 메시지가 전달됩니다. 원하는 방식으로 인증을 설정하세요. 일반적으로 동일한 저장소에 대해 먼저 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`은 `>=`, `<=`, `==`, `!=`, `>`을 지원합니다. `<` 또는 베어
버전(`>=`으로 처리). 현재 설치가 실패하면 명확한 오류가 발생하여 설치가 실패합니다.
에르메스 버전은 사양을 만족하지 않습니다.

`distribution_owned`은 선택 사항입니다. 설정된 경우 해당 경로만 교체됩니다.
업데이트; 프로필의 다른 모든 항목은 사용자 소유로 유지됩니다. 생략된 경우,
위의 기본값이 적용됩니다.

### 배포판 게시 \{#publishing-a-distribution}

배포판을 작성하는 것은 단지 git push입니다:

1. 프로필 디렉터리에서 최소한 `name`을 사용하여 `distribution.yaml`을 생성하세요.
및 `version`.
2. git repo를 초기화하고(또는 기존 저장소 사용) GitHub에 푸시합니다.
GitLab / Hermes가 복제할 수 있는 모든 호스트.
3. 수신자에게 `hermes profile install &lt;your-repo-url&gt;`을 실행하도록 안내하세요.

버전이 지정된 릴리스에 git 태그를 사용하세요. `HEAD`을 복제하는 수신자는
최신 상태이며 매니페스트에서 언제든지 `version:`을 확인할 수 있습니다.

## `hermes -p` / `hermes --profile` \{#hermes--p--hermes---profile}

```bash
hermes -p &lt;name&gt; &lt;command&gt; [options]
hermes --profile &lt;name&gt; &lt;command&gt; [options]

고정 기본값을 변경하지 않고 특정 프로필에서 Hermes 명령을 실행하는 전역 플래그입니다. 이는 명령 기간 동안 활성 프로필을 재정의합니다.

옵션	설명
`-p <name>`, `--profile <name>`	이 명령에 사용할 프로필입니다.

예:

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`

hermes completion &lt;shell&gt;

쉘 완성 스크립트를 생성합니다. 프로필 이름 및 프로필 하위 명령에 대한 완성이 포함됩니다.

인수	설명
`<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> — 프로필 이름

anchor alias​

프로필 명령 참조

hermes profile​

hermes profile list​

hermes profile use​

hermes profile create​

hermes profile delete​

hermes profile show​

hermes profile alias​

hermes profile rename​

hermes profile export​

hermes profile import​

배포 명령​

hermes profile install​

hermes profile update​

hermes profile info​

비공개 배포​

배포 매니페스트(distribution.yaml)​

hermes completion​

또한보십시오​