CLI 명령 참조

이 페이지에서는 셸에서 실행하는 터미널 명령을 다룹니다.

채팅 내 슬래시 명령어는 슬래시 명령어 참고를 참고하세요.

글로벌 진입점

hermes [global-options] <command> [subcommand/options]

글로벌 옵션

옵션	설명
--version, -V	버전을 표시하고 종료합니다.
--profile <name>, -p <name>	이 호출에 사용할 Hermes 프로필을 선택하세요. hermes profile use에 의해 설정된 고정 기본값을 재정의합니다.
--resume <session>, -r <session>	ID 또는 제목으로 이전 세션을 재개합니다.
--continue [name], -c [name]	가장 최근 세션 또는 제목과 일치하는 가장 최근 세션을 재개합니다.
--worktree, -w	병렬 에이전트 워크플로를 위해 격리된 Git 작업 트리에서 시작하세요.
--yolo	위험한 명령 승인 프롬프트를 우회합니다.
--pass-session-id	상담원의 시스템 프롬프트에 세션 ID를 포함합니다.
--ignore-user-config	~/.hermes/config.yaml을 무시하고 내장된 기본값으로 돌아갑니다. .env의 자격 증명이 아직 로드되어 있습니다.
--ignore-rules	AGENTS.md, SOUL.md, .cursorrules, 메모리 및 사전 로드된 기술의 자동 주입을 건너뜁니다.
--tui	기존 CLI 대신 TUI를 실행하세요. HERMES_TUI=1과 동일합니다.
--dev	--tui 사용: 사전 빌드된 번들 대신(TUI 기여자의 경우) tsx을 통해 TypeScript 소스를 직접 실행합니다.

최상위 명령

명령	목적
hermes chat	상담원과의 대화형 또는 일회성 채팅입니다.
hermes model	기본 공급자와 모델을 대화형으로 선택합니다.
hermes fallback	기본 모델에 오류가 있을 때 대체 공급자 관리를 시도했습니다.
hermes gateway	메시징 게이트웨이 서비스를 실행하거나 관리합니다.
hermes proxy	OAuth 공급자 자격 증명을 연결하는 로컬 OpenAI 호환 프록시입니다. 구독 프록시를 참조하세요.
hermes lsp	언어 서버 프로토콜 통합을 관리합니다(write_file/patch에 대한 의미 진단).
hermes setup	구성 전체 또는 일부에 대한 대화형 설정 마법사입니다.
hermes whatsapp	WhatsApp 브리지를 구성하고 페어링합니다.
hermes slack	Slack 도우미(현재: 모든 명령을 기본 슬래시로 사용하여 앱 매니페스트를 생성)
hermes auth	자격 증명 관리 — 추가, 나열, 제거, 재설정, 전략 설정. Codex/Nous/Anthropic에 대한 OAuth 흐름을 처리합니다.
hermes login / logout	더 이상 사용되지 않음 — 대신 hermes auth을 사용하세요.
hermes status	에이전트, 인증 및 플랫폼 상태를 표시합니다.
hermes cron	크론 스케줄러를 검사하고 선택합니다.
hermes kanban	다중 프로필 협업 보드(작업, 링크, 디스패처).
hermes webhook	이벤트 기반 활성화를 위한 동적 웹훅 구독을 관리합니다.
hermes hooks	config.yaml에 선언된 쉘 스크립트 후크를 검사, 승인 또는 제거합니다.
hermes doctor	구성 및 종속성 문제를 진단합니다.
hermes dump	지원/디버깅을 위한 복사-붙여넣기 가능한 설정 요약입니다.
hermes debug	디버그 도구 — 지원을 위해 로그 및 시스템 정보를 업로드합니다.
hermes backup	Hermes 홈 디렉토리를 zip 파일로 백업합니다.
hermes checkpoints	~/.hermes/checkpoints/(/rollback에서 사용하는 섀도우 저장소)을 검사/정리/삭제합니다. 상태 개요를 보려면 인수 없이 실행하세요.
hermes import	zip 파일에서 Hermes 백업을 복원합니다.
hermes logs	에이전트/게이트웨이/오류 로그 파일을 보고, 추적하고, 필터링합니다.
hermes config	구성 파일을 표시, 편집, 마이그레이션 및 쿼리합니다.
hermes pairing	메시징 페어링 코드를 승인하거나 취소합니다.
hermes skills	기술을 찾아보고, 설치하고, 게시하고, 감사하고, 구성하세요.
hermes curator	백그라운드 스킬 유지 관리 - 상태, 실행, 일시 중지, 고정. 큐레이터를 참조하세요.
hermes memory	외부 메모리 공급자를 구성합니다. 플러그인별 하위 명령(예: hermes honcho)은 공급자가 활성화되면 자동으로 등록됩니다.
hermes acp	에디터 통합을 위해 Hermes를 ACP 서버로 실행하세요.
hermes mcp	MCP 서버 구성을 관리하고 Hermes를 MCP 서버로 실행합니다.
hermes plugins	Hermes Agent 플러그인을 관리합니다(설치, 활성화, 비활성화, 제거).
hermes tools	플랫폼별로 활성화된 도구를 구성합니다.
hermes computer-use	cua-driver 백엔드를 설치하거나 확인합니다(macOS 컴퓨터 사용).
hermes sessions	세션을 찾아보고, 내보내고, 정리하고, 이름을 바꾸고, 삭제합니다.
hermes insights	토큰/비용/활동 분석을 표시합니다.
hermes claw	OpenClaw 마이그레이션 도우미.
hermes dashboard	구성, API 키, 세션 관리를 위한 웹 대시보드를 실행하세요.
hermes profile	프로필 관리 — 여러 개의 격리된 Hermes 인스턴스.
hermes completion	쉘 완성 스크립트(bash/zsh/fish)를 인쇄합니다.
hermes version	버전 정보를 표시합니다.
hermes update	최신 코드를 가져와 종속성을 다시 설치하거나(git 설치) PyPI 및 pip install --upgrade(pip 설치)을 확인하세요. --check 설치 없이 미리보기; --backup는 사전 풀 HERMES_HOME 스냅샷을 생성합니다.
hermes uninstall	시스템에서 헤르메스를 제거하십시오.

hermes chat

hermes chat [options]

일반적인 옵션:

옵션	설명
-q, --query "..."	일회성, 비대화형 프롬프트.
-m, --model <model>	이 실행을 위해 모델을 재정의합니다.
-t, --toolsets <csv>	쉼표로 구분된 도구 세트 세트를 활성화합니다.
--provider <provider>	공급자 강제: auto, openrouter, nous, openai-codex, copilot-acp, copilot, anthropic, gemini, google-gemini-cli, huggingface, novita, zai, kimi-coding, kimi-coding-cn, minimax, minimax-cn, minimax-oauth, kilocode, xiaomi, arcee, gmi, alibaba, alibaba-coding-plan(별칭 alibaba_coding), deepseek, nvidia, ollama-cloud, xai(별칭 grok), xai-oauth(별칭) grok-oauth), qwen-oauth, bedrock, opencode-zen, opencode-go, ai-gateway, azure-foundry, lmstudio, stepfun, tencent-tokenhub(별칭 tencent, tokenhub).
-s, --skills <name>	세션에 대해 하나 이상의 기술을 미리 로드합니다(반복되거나 쉼표로 구분될 수 있음).
-v, --verbose	자세한 출력.
-Q, --quiet	프로그래밍 모드: 배너/스피너/도구 미리보기를 억제합니다.
--image <path>	단일 쿼리에 로컬 이미지를 연결합니다.
--resume <session> / --continue [name]	chat에서 직접 세션을 재개하세요.
--worktree	이 실행을 위해 격리된 Git 작업 트리를 만듭니다.
--checkpoints	파괴적인 파일 변경 전에 파일 시스템 체크포인트를 활성화합니다.
--yolo	승인 프롬프트를 건너뜁니다.
--pass-session-id	세션 ID를 시스템 프롬프트에 전달합니다.
--ignore-user-config	~/.hermes/config.yaml을 무시하고 내장된 기본값을 사용하십시오. .env의 자격 증명이 아직 로드되어 있습니다. 격리된 CI 실행, 재현 가능한 버그 보고서 및 타사 통합에 유용합니다.
--ignore-rules	AGENTS.md, SOUL.md, .cursorrules, 영구 메모리 및 사전 로드된 기술의 자동 주입을 건너뜁니다. 완전히 격리된 실행을 위해 --ignore-user-config과 결합합니다.
--source <tag>	필터링을 위한 세션 소스 태그(기본값: cli). 사용자 세션 목록에 표시되어서는 안 되는 타사 통합에는 tool을 사용하세요.
--max-turns <N>	대화 차례당 최대 도구 호출 반복 횟수(기본값: 90 또는 구성에서 agent.max_turns).

예:

hermes
hermes chat -q "Summarize the latest PRs"
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills
hermes chat --quiet -q "Return only JSON"
hermes chat --worktree -q "Review this repo and open a PR"
hermes chat --ignore-user-config --ignore-rules -q "Repro without my personal setup"

hermes -z <prompt> — 스크립트된 일회성

프로그래밍 방식 호출자(셸 스크립트, CI, cron, 프롬프트의 상위 프로세스 파이프)의 경우 hermes -z은 가장 순수한 원샷 진입점입니다. 단일 프롬프트 입력, 최종 응답 텍스트 출력, stdout 또는 stderr에 다른 항목 없음 배너 없음, 스피너 없음, 도구 미리 보기 없음, Session: 줄 없음 - 일반 텍스트로 에이전트의 최종 응답만 가능합니다.

hermes -z "What's the capital of France?"
# → Paris.

# Parent scripts can cleanly capture the response:
answer=$(hermes -z "summarize this" < /path/to/file.txt)

실행별 재정의(~/.hermes/config.yaml에 대한 변형 없음):

깃발	동등한 환경 변수	목적
-m / --model <model>	HERMES_INFERENCE_MODEL	이 실행에 대한 모델 재정의
--provider <provider>	HERMES_INFERENCE_PROVIDER	이 실행에 대한 공급자 재정의

hermes -z "…" --provider openrouter --model openai/gpt-5.5
# or:
HERMES_INFERENCE_MODEL=anthropic/claude-sonnet-4.6 hermes -z "…"

동일한 에이전트, 동일한 도구, 동일한 기술 — 모든 대화형/외관 레이어를 제거합니다. 성적표에도 도구 출력이 필요한 경우 대신 hermes chat -q을 사용하세요. -z은 명시적으로 "최종 답변만 원합니다"입니다.

hermes model

대화형 공급자 + 모델 선택기. 이것은 새로운 공급자 추가, API 키 설정 및 OAuth 흐름 실행을 위한 명령입니다. 활성 Hermes 채팅 세션 내부가 아닌 터미널에서 실행하세요.

hermes model

다음과 같은 경우에 이것을 사용하세요:

• 새 공급자 추가(OpenRouter, Anthropic, Copilot, DeepSeek, 사용자 정의 등)
• OAuth 지원 제공업체(Anthropic, Copilot, Codex, Nous Portal)에 로그인합니다.
• API 키 입력 또는 업데이트
• 공급자별 모델 목록에서 선택
• 사용자 지정/자체 호스팅 끝점 구성
• 새로운 기본값을 구성에 저장

hermes model vs /model — know the difference

hermes model(Hermes 세션 외부의 터미널에서 실행)은 전체 공급자 설정 마법사입니다. 새 공급자를 추가하고, OAuth 흐름을 실행하고, API 키를 묻는 메시지를 표시하고, 엔드포인트를 구성할 수 있습니다.

/model(활성 Hermes 채팅 세션 내에 입력)은 이미 설정한 제공업체와 모델 간 전환만 가능합니다. 새 공급자를 추가하거나 OAuth를 실행하거나 API 키를 묻는 메시지를 표시할 수 없습니다.

새 공급자를 추가해야 하는 경우: 먼저 Hermes 세션을 종료한 후(Ctrl+C 또는 /quit) 터미널 프롬프트에서 hermes model을 실행하세요.

/model 슬래시 명령(세션 도중)

세션을 종료하지 않고 이미 구성된 모델 간 전환:

/model                              # Show current model and available options
/model claude-sonnet-4              # Switch model (auto-detects provider)
/model zai:glm-5                    # Switch provider and model
/model custom:qwen-2.5              # Use model on your custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Use a named custom provider
/model openrouter:anthropic/claude-sonnet-4  # Switch back to cloud

기본적으로 /model 변경 사항은 현재 세션에만 적용됩니다. --global을 추가하여 config.yaml에 대한 변경 사항을 유지합니다.

/model claude-sonnet-4 --global     # Switch and save as new default

What if I only see OpenRouter models?

OpenRouter만 구성한 경우 /model에는 OpenRouter 모델만 표시됩니다. 다른 공급자(Anthropic, DeepSeek, Copilot 등)를 추가하려면 세션을 종료하고 터미널에서 hermes model을 실행하세요.

공급자 및 기본 URL 변경 사항은 config.yaml에 자동으로 유지됩니다. 사용자 정의 엔드포인트에서 전환하면 오래된 기본 URL이 지워져 다른 공급자로 유출되는 것을 방지합니다.

hermes gateway

hermes gateway <subcommand>

하위 명령:

하위 명령	설명
run	포그라운드에서 게이트웨이를 실행합니다. WSL, Docker 및 Termux에 권장됩니다.
start	설치된 systemd/launchd 백그라운드 서비스를 시작합니다.
stop	서비스(또는 포그라운드 프로세스)를 중지합니다.
restart	서비스를 다시 시작하십시오.
status	서비스 상태를 표시합니다.
install	systemd(Linux) 또는 launchd(macOS) 백그라운드 서비스로 설치합니다.
uninstall	설치된 서비스를 제거합니다.
setup	대화형 메시징 플랫폼 설정.

옵션:

옵션	설명
--all	start / restart / stop: 활성 HERMES_HOME뿐만 아니라 모든 프로필의 게이트웨이에서 작동합니다. 여러 프로필을 나란히 실행하고 hermes update 이후에 모두 다시 시작하려는 경우에 유용합니다.

WSL users

hermes gateway start 대신 hermes gateway run을 사용하세요. — WSL의 systemd 지원은 신뢰할 수 없습니다. 지속성을 위해 tmux로 포장합니다: tmux new -s hermes 'hermes gateway run'. 자세한 내용은 WSL FAQ를 참조하세요.

hermes lsp

hermes lsp <subcommand>

언어 서버 프로토콜 통합을 관리합니다. LSP가 실제로 실행됩니다. 언어 서버(pyright, gopls, Rust-analyzer, …) 백그라운드에서 작성 후 검사에 진단 정보를 제공합니다. write_file 및 patch에서 사용됩니다. Git 작업 공간 감지 시 게이트됨 — LSP는 cwd 또는 편집된 파일이 git 내부에 있을 때만 실행됩니다. 작업 트리.

하위 명령:

하위 명령	설명
status	서비스 상태, 구성된 서버, 설치 상태를 표시합니다.
list	지원되는 서버의 레지스트리를 인쇄합니다. 누락된 항목을 건너뛰려면 --installed-only을 전달하세요.
install <id>	한 서버의 바이너리를 적극적으로 설치하십시오.
install-all	알려진 자동 설치 레시피를 사용하여 모든 서버를 설치합니다.
restart	다음 편집이 다시 생성되도록 실행 중인 클라이언트를 해제합니다.
which <id>	한 서버에 대해 확인된 바이너리 경로를 인쇄합니다.

자세한 내용은 LSP — 의미 진단을 참조하세요. 전체 가이드, 지원되는 언어 및 구성 손잡이.

hermes setup

hermes setup [model|tts|terminal|gateway|tools|agent] [--non-interactive] [--reset] [--quick] [--reconfigure]

첫 번째 실행: 최초 마법사를 시작합니다.

복귀 사용자(이미 구성됨): 전체 재구성 마법사로 바로 이동합니다. 모든 프롬프트에는 현재 값이 기본값으로 표시됩니다. 유지하려면 Enter를 누르거나 새 값을 입력하세요. 메뉴가 없습니다.

전체 마법사 대신 하나의 섹션으로 이동하십시오.

섹션	설명
model	공급자 및 모델 설정.
terminal	터미널 백엔드 및 샌드박스 설정.
gateway	메시징 플랫폼 설정.
tools	플랫폼별로 도구를 활성화/비활성화합니다.
agent	에이전트 행동 설정.

옵션:

옵션	설명
--quick	재사용자 실행 시: 누락되거나 설정되지 않은 항목에 대해서만 메시지를 표시합니다. 이미 구성한 항목을 건너뜁니다.
--non-interactive	프롬프트 없이 기본값/환경 값을 사용합니다.
--reset	설정하기 전에 구성을 기본값으로 재설정하세요.
--reconfigure	이전 버전과 호환되는 별칭 — 기존 설치의 베어 hermes setup이 이제 기본적으로 이 작업을 수행합니다.

hermes whatsapp

hermes whatsapp

모드 선택 및 QR 코드 페어링을 포함하여 WhatsApp 페어링/설정 흐름을 실행합니다.

hermes slack

hermes slack manifest              # print manifest to stdout
hermes slack manifest --write      # write to ~/.hermes/slack-manifest.json
hermes slack manifest --slashes-only  # just the features.slash_commands array

모든 게이트웨이 명령을 등록하는 Slack 앱 매니페스트를 생성합니다. COMMAND_REGISTRY (/btw, /stop, /model, …)을 최상급으로 Slack 슬래시 명령 — Discord 및 Telegram 패리티와 일치합니다. 붙여넣기 Slack 앱 구성으로 출력 https://api.slack.com/apps → 앱 → 기능 → 앱 매니페스트 → 편집, 저장을 차례로 선택하세요. Slack에서 다음에 대한 메시지를 표시합니다. 범위 또는 슬래시 명령이 변경된 경우 다시 설치하십시오.

깃발	기본값	목적
--write [PATH]	표준 출력	stdout 대신 파일에 씁니다. 베어 --write은 $HERMES_HOME/slack-manifest.json을 씁니다.
--name NAME	Hermes	Slack의 봇 표시 이름입니다.
--description DESC	기본 광고	Slack 앱 디렉토리에 표시된 봇 설명입니다.
--slashes-only	떨어져서	수동으로 관리되는 매니페스트에 병합하기 위해 features.slash_commands만 내보냅니다.

hermes update 다음에 hermes slack manifest --write을 다시 실행하여 선택합니다. 새로운 명령을 실행하세요.

hermes login / hermes logout (더 이상 사용되지 않음)

{#hermes-login--hermes-logout-deprecated}

hermes login이 제거되었습니다. OAuth 자격 증명을 관리하려면 hermes auth을 사용하고, 공급자를 선택하려면 hermes model을 사용하고, 전체 대화형 설정을 위해서는 hermes setup을 사용하세요.

hermes auth

동일한 공급자 키 순환을 위한 자격 증명 풀을 관리합니다. 전체 문서는 자격 증명 풀을 참조하세요.

hermes auth                                              # Interactive wizard
hermes auth list                                         # Show all pools
hermes auth list openrouter                              # Show specific provider
hermes auth add openrouter --api-key sk-or-v1-xxx        # Add API key
hermes auth add anthropic --type oauth                   # Add OAuth credential
hermes auth remove openrouter 2                          # Remove by index
hermes auth reset openrouter                             # Clear cooldowns
hermes auth status anthropic                             # Show auth status for a provider
hermes auth logout anthropic                             # Log out and clear stored auth state
hermes auth spotify                                      # Authenticate Hermes with Spotify via PKCE

하위 명령: add, list, remove, reset, status, logout, spotify. 하위 명령 없이 호출하면 대화형 관리 마법사가 시작됩니다.

hermes status

hermes status [--all] [--deep]

옵션	설명
--all	공유 가능한 수정된 형식으로 모든 세부정보를 표시합니다.
--deep	시간이 더 오래 걸릴 수 있는 심층적인 검사를 실행하세요.

hermes cron

hermes cron <list|create|edit|pause|resume|run|remove|status|tick>

하위 명령	설명
list	예약된 작업을 표시합니다.
create / add	프롬프트에서 예약된 작업을 생성하고 선택적으로 반복되는 --skill을 통해 하나 이상의 기술을 연결합니다.
edit	작업 일정, 프롬프트, 이름, 전달, 반복 횟수 또는 연결된 기술을 업데이트합니다. --clear-skills, --add-skill 및 --remove-skill을 지원합니다.
pause	작업을 삭제하지 않고 일시 중지합니다.
resume	일시 중지된 작업을 재개하고 다음 번 실행을 계산합니다.
run	다음 스케줄러 틱에서 작업을 트리거합니다.
remove	예약된 작업을 삭제합니다.
status	크론 스케줄러가 실행 중인지 확인하세요.
tick	예정된 작업을 한 번 실행하고 종료합니다.

hermes kanban

hermes kanban [--board <slug>] <action> [options]

다중 프로필, 다중 프로젝트 협업 보드. 각 설치는 많은 보드(프로젝트, 저장소 또는 도메인당 하나)를 호스팅할 수 있습니다. 각 보드는 자체 SQLite DB 및 디스패처 범위가 있는 독립형 대기열입니다. 새로운 설치는 default이라는 하나의 보드로 시작됩니다. 이 보드의 DB는 이전 버전과 호환되는 경우 ~/.hermes/kanban.db입니다. 추가 보드는 ~/.hermes/kanban/boards/<slug>/kanban.db에 있습니다. 게이트웨이 내장 디스패처는 틱당 모든 보드를 스윕합니다.

전역 플래그(아래 모든 작업에 적용):

깃발	목적
--board <slug>	특정 보드에서 작동합니다. 기본값은 현재 보드입니다(hermes kanban boards switch, HERMES_KANBAN_BOARD env var 또는 default을 통해 설정).

이것은 인간/스크립팅 표면입니다. 디스패처에 의해 생성된 에이전트 작업자는 전용 kanban_* 도구 세트(kanban_show, kanban_complete, kanban_block, kanban_create, kanban_link, kanban_comment, kanban_heartbeat)을 hermes kanban로 포격하는 대신. 작업자는 자신의 환경에 HERMES_KANBAN_BOARD을 고정하여 물리적으로 다른 보드를 볼 수 없습니다.

액션	목적
init	누락된 경우 kanban.db을 생성하세요. 멱등성.
boards list / boards ls	작업 개수와 함께 모든 보드를 나열합니다. --json, --all(보관된 항목 포함)
boards create <slug>	새 보드를 만듭니다. 플래그: --name, --description, --icon, --color, --switch(활성화). 슬러그는 케밥 케이스이며 자동으로 다운됩니다.
boards switch <slug> / boards use	<slug>을 활성 보드로 유지합니다(~/.hermes/kanban/current 작성).
boards show / boards current	현재 활성화된 보드의 이름, DB 경로, 태스크 개수를 출력합니다.
boards rename <slug> "<name>"	보드의 표시 이름을 변경합니다. 슬러그는 불변입니다.
boards rm <slug>	보드를 보관(기본값)하거나 영구 삭제합니다. --delete은 보관 단계를 건너뜁니다. 보관된 보드는 boards/_archived/<slug>-<ts>/로 이동됩니다. default 때문에 거부되었습니다.
create "<title>"	활성 보드에 새 작업을 만듭니다. 플래그: --body, --assignee, --parent(반복 가능), --작업 공간 스크래치|작업트리|디렉토리:<path>, --tenant, --priority, - -triage, --멱등성-키, --max-runtime, --skill (반복 가능).
list / ls	활성 보드에 작업을 나열합니다. --mine, --assignee, --status, --tenant, --archived, --json로 필터링합니다.
show <id>	댓글과 이벤트가 포함된 작업을 표시하세요. 기계 출력용 --json.
assign <id> <profile>	할당하거나 재할당하세요. 할당을 취소하려면 none을 사용하세요. 작업이 실행되는 동안 거부되었습니다.
link <parent> <child>	종속성을 추가합니다. 사이클이 감지되었습니다. 두 작업 모두 동일한 보드에 있어야 합니다.
unlink <parent> <child>	종속성을 제거합니다.
claim <id>	준비된 작업을 원자적으로 청구합니다. 확인된 작업 공간 경로를 인쇄합니다.
comment <id> "<text>"	댓글을 추가하세요. 작업을 요청하는 다음 작업자는 해당 작업을 kanban_show() 응답의 일부로 읽습니다.
complete <id>	작업을 완료로 표시하세요. 플래그: --result, --summary, --metadata.
block <id> "<reason>"	작업을 차단된 것으로 표시합니다. 또한 이유를 주석으로 추가합니다.
unblock <id>	차단된 작업을 준비 상태로 되돌립니다.
archive <id>	기본 목록에서 숨깁니다. gc은 스크래치 작업공간을 제거합니다.
tail <id>	작업의 이벤트 스트림을 따릅니다.
dispatch	하나의 디스패처가 활성 보드를 전달합니다. 플래그: --dry-run, --max N, --json.
context <id>	작업자에게 표시되는 전체 컨텍스트(제목 + 본문 + 상위 결과 + 설명)를 인쇄합니다.
specify <id> / specify --all	보조 LLM을 통해 분류 열 작업을 구체적인 사양(제목 + 목표, 접근 방식, 승인 기준이 포함된 본문)으로 구체화한 다음 이를 todo으로 승격합니다. 플래그: --tenant(범위 --all ~ 한 테넌트), --author, --json. config.yaml의 auxiliary.triage_specifier에서 모델을 구성합니다.
gc	보관된 작업에 대한 스크래치 작업 공간을 제거합니다.

예:

# Create a second board and put a task on it without switching away.
hermes kanban boards create atm10-server --name "ATM10 Server" --icon 🎮
hermes kanban --board atm10-server create "Restart server" --assignee ops

# Switch the active board for subsequent calls.
hermes kanban boards switch atm10-server
hermes kanban list                  # shows atm10-server tasks

# Archive a board (recoverable) or hard-delete it.
hermes kanban boards rm atm10-server
hermes kanban boards rm atm10-server --delete

보드 해결 순서(우선 순위가 가장 높은 것부터): --board <slug> 플래그 → HERMES_KANBAN_BOARD env var → ~/.hermes/kanban/current 파일 → default.

모든 작업은 boards 하위 명령 및 --board 플래그를 포함하여 동일한 인수 표면을 사용하여 게이트웨이(/kanban …)에서 슬래시 명령으로도 사용할 수 있습니다.

전체 설계(Cline Kanban / Paperclip / NanoClaw / Gemini Enterprise와의 비교, 8가지 협업 패턴, 4가지 사용자 스토리, 동시성 정확성 증명)는 저장소의 docs/hermes-kanban-v1-spec.pdf 또는 Kanban 사용자 가이드를 참조하세요.

hermes webhook

hermes webhook <subscribe|list|remove|test>

이벤트 기반 에이전트 활성화를 위한 동적 웹후크 구독을 관리합니다. 구성에서 웹훅 플랫폼을 활성화해야 합니다. 구성되지 않은 경우 설정 지침이 인쇄됩니다.

하위 명령	설명
subscribe / add	웹훅 경로를 생성합니다. 서비스에 구성할 URL 및 HMAC 비밀번호를 반환합니다.
list / ls	에이전트가 생성한 구독을 모두 표시합니다.
remove / rm	동적 구독을 삭제합니다. config.yaml의 정적 경로는 영향을 받지 않습니다.
test	테스트 POST를 보내 구독이 작동하는지 확인하세요.

hermes webhook subscribe

hermes webhook subscribe <name> [options]

옵션	설명
--prompt	{dot.notation} 페이로드 참조가 포함된 프롬프트 템플릿입니다.
--events	허용할 쉼표로 구분된 이벤트 유형입니다(예: issues,pull_request). 비어 있음 = 모두.
--description	사람이 읽을 수 있는 설명입니다.
--skills	에이전트 실행을 위해 로드할 쉼표로 구분된 스킬 이름입니다.
--deliver	배송 대상: log(기본값), telegram, discord, slack, github_comment.
--deliver-chat-id	크로스 플랫폼 전달을 위한 대상 채팅/채널 ID입니다.
--secret	커스텀 HMAC 비밀번호입니다. 생략시 자동 생성됩니다.
--deliver-only	에이전트를 건너뛰고 렌더링된 --prompt을 리터럴 메시지로 전달합니다. LLM 비용이 없고 1초 미만의 배송이 가능합니다. 실제 대상이 되려면 --deliver이 필요합니다(log 아님).

구독은 ~/.hermes/webhook_subscriptions.json에 유지되며 게이트웨이를 다시 시작하지 않고도 웹후크 어댑터에 의해 핫 다시 로드됩니다.

hermes doctor

hermes doctor [--fix]

옵션	설명
--fix	가능한 경우 자동 복구를 시도하십시오.

hermes dump

hermes dump [--show-keys]

전체 Hermes 설정에 대한 간단한 일반 텍스트 요약을 출력합니다. 지원을 요청할 때 Discord, GitHub 문제 또는 Telegram에 복사하여 붙여넣을 수 있도록 설계되었습니다. ANSI 색상도 없고 특별한 형식도 없으며 데이터만 있습니다.

옵션	설명
--show-keys	set/not set 대신 수정된 API 키 접두사(첫 번째 및 마지막 4자)를 표시합니다.

포함 내용

섹션	세부정보
헤더	헤르메스 버전, 출시일, git 커밋 해시
환경	OS, Python 버전, OpenAI SDK 버전
신원	활성 프로필 이름, HERMES_HOME 경로
모델	구성된 기본 모델 및 공급자
터미널	백엔드 유형(local, docker, ssh 등)
API 키	22개 공급자/도구 API 키 모두에 대한 존재 확인
특징	활성화된 도구 세트, MCP 서버 수, 메모리 공급자
서비스	게이트웨이 상태, 구성된 메시징 플랫폼
워크로드	크론 작업 수, 설치된 스킬 수
구성 재정의	기본값과 다른 구성 값

예제 출력

--- hermes dump ---
version:          0.8.0 (2026.4.8) [af4abd2f]
os:               Linux 6.14.0-37-generic x86_64
python:           3.11.14
openai_sdk:       2.24.0
profile:          default
hermes_home:      ~/.hermes
model:            anthropic/claude-opus-4.6
provider:         openrouter
terminal:         local

api_keys:
  openrouter           set
  openai               not set
  anthropic            set
  nous                 not set
  firecrawl            set...

features:
  toolsets:           all
  mcp_servers:        0
  memory_provider:    built-in
  gateway:            running (systemd)
  platforms:          telegram, discord
  cron_jobs:          3 active / 5 total
  skills:             42

config_overrides:
  agent.max_turns: 250
  compression.threshold: 0.85
  display.streaming: True
--- end dump ---

언제 사용하나요?

• GitHub에서 버그 보고 — 덤프를 문제에 붙여넣기
• Discord에서 도움 요청 - 코드 블록에서 공유
• 귀하의 설정을 다른 사람의 설정과 비교
• 무언가가 작동하지 않을 때 빠른 상태 점검

팁

hermes dump은 공유를 위해 특별히 설계되었습니다. 대화형 진단의 경우 hermes doctor을 사용합니다. 시각적 개요를 보려면 hermes status을 사용하세요.

hermes debug

hermes debug share [options]

디버그 보고서(시스템 정보 + 최근 로그)를 붙여넣기 서비스에 업로드하고 공유 가능한 URL을 받으세요. 빠른 지원 요청에 유용합니다. 도우미가 문제를 진단하는 데 필요한 모든 것이 포함되어 있습니다.

옵션	설명
--lines <N>	로그 파일당 포함할 로그 줄 수(기본값: 200)
--expire <days>	만료일을 붙여넣습니다(기본값: 7).
--local	보고서를 업로드하는 대신 로컬로 인쇄하세요.

보고서에는 시스템 정보(OS, Python 버전, Hermes 버전), 최근 에이전트 및 게이트웨이 로그(파일당 제한), 수정된 API 키 상태가 포함됩니다. 키는 항상 수정되며 비밀은 업로드되지 않습니다.

붙여넣기 서비스는 Paste.rs, dpaste.com 순서로 시도되었습니다.

예

hermes debug share              # Upload debug report, print URL
hermes debug share --lines 500  # Include more log lines
hermes debug share --expire 30  # Keep paste for 30 days
hermes debug share --local      # Print report to terminal (no upload)

hermes backup

hermes backup [options]

Hermes 구성, 기술, 세션 및 데이터의 zip 아카이브를 만듭니다. 백업에서는 hermes-agent 코드베이스 자체가 제외됩니다.

옵션	설명
-o, --output <path>	zip 파일의 출력 경로(기본값: ~/hermes-backup-<timestamp>.zip).
-q, --quick	빠른 스냅샷: 중요한 상태 파일(config.yaml, state.db,.env, auth, cron 작업)만. 전체 백업보다 훨씬 빠릅니다.
-l, --label <name>	스냅샷의 라벨입니다(--quick에만 사용됨).

백업은 안전한 복사를 위해 SQLite의 backup() API를 사용하므로 Hermes가 실행 중일 때도(WAL 모드 안전) 올바르게 작동합니다.

zip에서 제외되는 내용:

• *.db-wal, *.db-shm, *.db-journal — SQLite의 WAL/공유 메모리/저널 사이드카. *.db 파일은 이미 sqlite3.backup()을 통해 일관된 스냅샷을 얻었습니다. 라이브 사이드카를 함께 배송하면 복원에서 절반 커밋된 상태를 볼 수 있습니다.
• checkpoints/ — 세션별 궤적 캐시. 세션별로 해시 키가 지정되고 재생성됩니다. 어쨌든 다른 설치로 깔끔하게 포팅되지는 않습니다.
• hermes-agent 코드 자체(이것은 저장소 스냅샷이 아닌 사용자 데이터 백업입니다).

예

hermes backup                           # Full backup to ~/hermes-backup-*.zip
hermes backup -o /tmp/hermes.zip        # Full backup to specific path
hermes backup --quick                   # Quick state-only snapshot
hermes backup --quick --label "pre-upgrade"  # Quick snapshot with label

hermes checkpoints

hermes checkpoints [COMMAND]

세션 내 /rollback 명령 뒤에 있는 스토리지 계층인 ~/.hermes/checkpoints/에서 섀도우 git 저장소를 검사하고 관리합니다. 언제든지 안전하게 실행할 수 있습니다. 에이전트를 실행할 필요가 없습니다.

하위 명령	설명
status (기본값)	전체 크기, 프로젝트 수, 프로젝트별 분석을 표시합니다. 베어 hermes checkpoints은 동일합니다.
list	status의 별칭입니다.
prune	정리 청소를 강제합니다. 고아 및 오래된 프로젝트를 삭제하고, 저장소를 GC하고, 크기 제한을 적용합니다. 24시간 멱등성 마커를 무시합니다.
clear	체크포인트 베이스 전체를 삭제하세요. 뒤집을 수 없는; -f이 아닌 경우 확인을 요청합니다.
clear-legacy	v1→v2 마이그레이션으로 생성된 legacy-<timestamp>/ 아카이브만 삭제합니다.

옵션

옵션	하위 명령	설명
--limit N	status, list	나열할 최대 프로젝트(기본값 20)
--retention-days N	prune	last_touch이 N일(기본값 7)보다 오래된 프로젝트를 삭제합니다.
--max-size-mb N	prune	고아/부실 단계 이후에는 총 저장소 크기가 NMB(기본값 500)가 될 때까지 프로젝트당 가장 오래된 커밋을 삭제합니다.
--keep-orphans	prune	작업 디렉터리가 더 이상 존재하지 않는 프로젝트 삭제를 건너뜁니다.
-f, --force	clear, clear-legacy	확인 메시지를 건너뜁니다.

예

hermes checkpoints                                  # status overview
hermes checkpoints prune --retention-days 3         # aggressive cleanup
hermes checkpoints prune --max-size-mb 200          # tighten size cap once
hermes checkpoints clear-legacy -f                  # drop v1 archive dirs
hermes checkpoints clear -f                         # wipe everything

전체 아키텍처 및 세션 내 명령은 체크포인트 및 /rollback을 참조하세요.

hermes import

hermes import <zipfile> [options]

이전에 생성된 Hermes 백업을 Hermes 홈 디렉터리에 복원합니다. 아카이브의 모든 파일은 Hermes 홈에 있는 기존 파일을 덮어씁니다. --force은 대상에 이미 Hermes 설치가 있는 경우 실행되는 확인 프롬프트만 건너뜁니다.

옵션	설명
-f, --force	기존 설치 확인 프롬프트를 건너뜁니다.

경고

실행 중인 프로세스와의 충돌을 방지하려면 가져오기 전에 게이트웨이를 중지하세요.

예

hermes import ~/hermes-backup-20260423.zip           # Prompts before overwriting existing config
hermes import ~/hermes-backup-20260423.zip --force   # Overwrite without prompting

hermes logs

hermes logs [log_name] [options]

Hermes 로그 파일을 보고, 추적하고, 필터링합니다. 모든 로그는 ~/.hermes/logs/(또는 기본이 아닌 프로필의 경우 <profile>/logs/)에 저장됩니다.

로그 파일

이름	파일	캡처하는 내용
agent (기본값)	agent.log	모든 에이전트 활동 — API 호출, 도구 디스패치, 세션 수명 주기(INFO 이상)
errors	errors.log	경고 및 오류만 — Agent.log의 필터링된 하위 집합
gateway	gateway.log	메시징 게이트웨이 활동 — 플랫폼 연결, 메시지 발송, 웹후크 이벤트

옵션

옵션	설명
log_name	확인할 로그: agent(기본값), errors, gateway 또는 list(사용 가능한 파일 크기 표시)
-n, --lines <N>	표시할 줄 수(기본값: 50)
-f, --follow	tail -f과 같이 실시간으로 로그인을 팔로우하세요. 중지하려면 Ctrl+C를 누르세요.
--level <LEVEL>	표시할 최소 로그 수준: DEBUG, INFO, WARNING, ERROR, CRITICAL.
--session <ID>	세션 ID 하위 문자열이 포함된 행을 필터링합니다.
--since <TIME>	상대적인 시간 전의 행 표시: 30m, 1h, 2d 등. s(초), m(분)을 지원합니다. h(시간), d(일).
--component <NAME>	구성 요소별로 필터링: gateway, agent, tools, cli, cron.

예

# View the last 50 lines of agent.log (default)
hermes logs

# Follow agent.log in real time
hermes logs -f

# View the last 100 lines of gateway.log
hermes logs gateway -n 100

# Show only warnings and errors from the last hour
hermes logs --level WARNING --since 1h

# Filter by a specific session
hermes logs --session abc123

# Follow errors.log, starting from 30 minutes ago
hermes logs errors --since 30m -f

# List all log files with their sizes
hermes logs list

필터링

필터를 결합할 수 있습니다. 여러 필터가 활성화된 경우 로그 줄은 해당 필터를 모두 전달해야 표시됩니다.

# WARNING+ lines from the last 2 hours containing session "tg-12345"
hermes logs --level WARNING --since 2h --session tg-12345

구문 분석 가능한 타임스탬프가 없는 줄은 --since이 활성화된 경우 포함됩니다(여러 줄의 로그 항목에서 이어지는 줄일 수 있음). --level이 활성화되면 감지 가능한 수준이 없는 줄이 포함됩니다.

로그 회전

Hermes는 Python의 RotatingFileHandler을 사용합니다. 이전 로그는 자동으로 회전됩니다. agent.log.1, agent.log.2 등을 찾으세요. hermes logs list 하위 명령은 회전된 로그 파일을 포함한 모든 로그 파일을 표시합니다.

hermes config

hermes config <subcommand>

하위 명령:

하위 명령	설명
show	현재 구성 값을 표시합니다.
edit	편집기에서 config.yaml을 엽니다.
set <key> <value>	구성 값을 설정합니다.
path	구성 파일 경로를 인쇄합니다.
env-path	.env 파일 경로를 인쇄합니다.
check	누락되었거나 오래된 구성이 있는지 확인하세요.
migrate	새로 도입된 옵션을 대화형으로 추가합니다.

hermes pairing

hermes pairing <list|approve|revoke|clear-pending>

하위 명령	설명
list	보류 중인 사용자와 승인된 사용자를 표시합니다.
approve <platform> <code>	페어링 코드를 승인하세요.
revoke <platform> <user-id>	사용자의 액세스 권한을 취소합니다.
clear-pending	대기 중인 페어링 코드를 삭제하세요.

hermes skills

hermes skills <subcommand>

하위 명령:

하위 명령	설명
browse	기술 등록을 위한 페이지가 매겨진 브라우저입니다.
search	스킬 레지스트리를 검색합니다.
install	스킬을 설치합니다.
inspect	스킬을 설치하지 않고 미리 볼 수 있습니다.
list	설치된 스킬을 나열합니다.
check	업스트림 업데이트를 위해 설치된 허브 기술을 확인하세요.
update	가능한 경우 업스트림 변경 사항으로 허브 기술을 다시 설치합니다.
audit	설치된 허브 스킬을 다시 스캔합니다.
uninstall	허브에 설치된 스킬을 제거합니다.
reset	매니페스트 항목을 지워 user_modified으로 표시된 번들 스킬을 고정 해제합니다. --restore을 사용하면 사용자 복사본도 번들 버전으로 대체됩니다.
publish	레지스트리에 스킬을 게시합니다.
snapshot	스킬 구성 내보내기/가져오기.
tap	맞춤형 스킬 소스를 관리하세요.
config	플랫폼별 기술에 대한 대화형 활성화/비활성화 구성입니다.

일반적인 예:

hermes skills browse
hermes skills browse --source official
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect official/security/1password
hermes skills inspect skills-sh/vercel-labs/json-render/json-render-react
hermes skills install official/migration/openclaw-migration
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills install https://sharethis.chat/SKILL.md                     # Direct URL (single-file SKILL.md)
hermes skills install https://example.com/SKILL.md --name my-skill        # Override name when frontmatter has none
hermes skills check
hermes skills update
hermes skills config
hermes skills reset google-workspace
hermes skills reset google-workspace --restore --yes

참고:

• --force은 타사/커뮤니티 기술에 대해 위험하지 않은 정책 차단을 재정의할 수 있습니다.
• --force은 dangerous 스캔 결과를 재정의하지 않습니다.
• --source skills-sh은 공개 skills.sh 디렉터리를 검색합니다.
• --source well-known을 사용하면 /.well-known/skills/index.json을 노출하는 사이트에서 Hermes를 가리킬 수 있습니다.
• http(s)://…/*.md URL을 전달하면 단일 파일 SKILL.md가 직접 설치됩니다. 머리말에 name:이 없고 URL 슬러그가 유효한 식별자가 아닌 경우 대화형 터미널에서 이름을 묻는 메시지를 표시합니다. 비대화형 표면(TUI 내부의 /skills install, 게이트웨이 플랫폼)에는 대신 --name <x>이 필요합니다.

hermes curator

hermes curator <subcommand>

큐레이터는 에이전트가 생성한 기술을 주기적으로 검토하고, 오래된 기술을 정리하고, 중복된 부분을 통합하고, 사용되지 않는 기술을 보관하는 보조 모델 백그라운드 작업입니다. 번들 및 허브에 설치된 기술은 절대 건드릴 수 없습니다. 아카이브는 복구 가능합니다. 자동 삭제는 절대 발생하지 않습니다.

하위 명령	설명
status	큐레이터 상태 및 스킬 통계 표시
run	지금 큐레이터 검토를 시작하세요(LLM 패스가 완료될 때까지 차단).
run --background	백그라운드 스레드에서 LLM 패스를 시작하고 즉시 반환
run --dry-run	미리보기 전용 - 변형 없이 리뷰 보고서를 생성합니다.
backup	~/.hermes/skills/의 수동 tar.gz 스냅샷을 찍습니다. (큐레이터는 또한 모든 실제 실행 전에 자동으로 스냅샷을 찍습니다.)
rollback	스냅샷에서 ~/.hermes/skills/ 복원(기본값은 최신)
rollback --list	사용 가능한 스냅샷 나열
rollback --id <ts>	ID별로 특정 스냅샷 복원
rollback -y	확인 프롬프트 건너뛰기
pause	재개될 때까지 큐레이터를 일시중지합니다.
resume	일시중지된 큐레이터 재개
pin <skill>	큐레이터가 자동으로 전환하지 않도록 스킬을 고정하세요.
unpin <skill>	스킬 고정 해제
restore <skill>	보관된 기술 복원
archive <skill>	수동으로 기술 보관
prune	큐레이터가 일반적으로 정리하는 기술을 수동으로 정리합니다.
list-archived	보관된 기술 목록(restore을 통해 복구 가능)

새로 설치하면 첫 번째 예약된 패스가 전체 interval_hours(기본적으로 7일)만큼 연기됩니다. 게이트웨이는 hermes update 이후 첫 번째 틱에서 즉시 선별되지 않습니다. 그런 일이 발생하기 전에 미리 보려면 hermes curator run --dry-run을 사용하세요.

동작 및 구성은 큐레이터를 참조하세요.

hermes fallback

hermes fallback <subcommand>

대체 공급자 체인을 관리합니다. 기본 모델이 속도 제한, 과부하 또는 연결 오류로 인해 실패하면 대체 공급자가 순서대로 시도됩니다.

하위 명령	설명
list(별칭: ls)	현재 대체 체인 표시(하위 명령이 없는 경우 기본값)
add	공급자 + 모델(hermes model과 동일한 선택기)을 선택하고 체인에 추가합니다.
remove(별칭: rm)	체인에서 삭제할 항목을 선택하세요.
clear	모든 대체 항목 제거

대체 공급자를 참조하세요.

hermes hooks

hermes hooks <subcommand>
``~/.hermes/config.yaml`에 선언된 셸 스크립트 후크를 검사하고, 합성 페이로드에 대해 테스트하고, `~/.hermes/shell-hooks-allowlist.json`에서 최초 사용 동의 허용 목록을 관리하세요.

| 하위 명령 | 설명 |
|------------|-------------|
| `list`(별칭: `ls`) | 일치자, 시간 초과 및 동의 상태와 함께 구성된 후크 나열 |
| `test &lt;event&gt;` | 합성 페이로드에 대해 `&lt;event&gt;`과 일치하는 모든 후크를 실행합니다. |
| `revoke`(별칭: `remove`, `rm`) | 명령의 허용 목록 항목 제거(다음에 다시 시작할 때 적용됨) |
| `doctor` | 구성된 각 후크 확인: 실행 비트, 허용 목록, mtime 드리프트, JSON 유효성 및 합성 실행 타이밍 |

이벤트 서명 및 페이로드 형태는 [후크](../user-guide/features/hooks.md)를 참조하세요.

## `hermes memory` \{#hermes-memory}

```bash
hermes memory &lt;subcommand&gt;

외부 메모리 공급자 플러그인을 설정하고 관리합니다. 사용 가능한 공급자: honcho, openviking, mem0, hindsight, holographic, acquiredb, byteover, supermemory. 한 번에 하나의 외부 공급자만 활성화될 수 있습니다. 내장 메모리(MEMORY.md/USER.md)는 항상 활성화되어 있습니다.

하위 명령:

하위 명령	설명
setup	대화형 공급자 선택 및 구성.
status	현재 메모리 공급자 구성을 표시합니다.
off	외부 공급자를 비활성화합니다(기본 제공만 해당).

Provider-specific subcommands

외부 메모리 공급자가 활성화되면 공급자별 관리를 위해 자체 최상위 hermes <provider> 명령을 등록할 수 있습니다(예: Honcho가 활성화된 경우 hermes honcho). 비활성 공급자는 해당 하위 명령을 노출하지 않습니다. hermes --help을 실행하여 현재 연결된 내용을 확인하세요.

hermes acp

hermes acp

편집기 통합을 위해 Hermes를 ACP(Agent Client Protocol) stdio 서버로 시작합니다.

관련 진입점:

hermes-acp
python -m acp_adapter

먼저 지원을 설치하세요.

pip install -e '.[acp]'

ACP 편집기 통합 및 ACP 내부를 참조하세요.

hermes mcp

hermes mcp <subcommand>

MCP(Model Context Protocol) 서버 구성을 관리하고 Hermes를 MCP 서버로 실행합니다.

하위 명령	설명
서빙 [-v|--상세]	Hermes를 MCP 서버로 실행하여 대화를 다른 에이전트에게 공개하세요.
추가 <name> [--url URL] [--command CMD] [--args...] [--auth oauth|헤더]	자동 도구 검색을 통해 MCP 서버를 추가합니다.
remove <name>(별칭: rm)	구성에서 MCP 서버를 제거합니다.
list(별칭: ls)	구성된 MCP 서버를 나열합니다.
test <name>	MCP 서버에 대한 연결을 테스트합니다.
configure <name>(별칭: config)	서버에 대한 도구 선택을 전환합니다.
login <name>	OAuth 기반 MCP 서버에 대한 재인증을 강제합니다.

MCP 구성 참조, Hermes와 함께 MCP 사용 및 MCP 서버 모드를 참조하세요.

hermes plugins

hermes plugins [subcommand]

통합 플러그인 관리 - 일반 플러그인, 메모리 공급자, 컨텍스트 엔진을 한 곳에서 관리합니다. 하위 명령 없이 hermes plugins을 실행하면 다음 두 섹션이 있는 복합 대화형 화면이 열립니다.

• 일반 플러그인 — 설치된 플러그인을 활성화/비활성화하는 다중 선택 확인란
• 공급자 플러그인 — 메모리 공급자 및 컨텍스트 엔진에 대한 단일 선택 구성입니다. 카테고리에서 Enter 키를 눌러 라디오 선택기를 엽니다.

하위 명령	설명
(없음)	복합 대화형 UI — 일반 플러그인 토글 + 공급자 플러그인 구성.
install <identifier> [--force]	Git URL 또는 owner/repo에서 플러그인을 설치하세요.
update <name>	설치된 플러그인의 최신 변경 사항을 가져옵니다.
remove <name>(별칭: rm, uninstall)	설치된 플러그인을 제거합니다.
enable <name>	비활성화된 플러그인을 활성화합니다.
disable <name>	플러그인을 제거하지 않고 비활성화하세요.
list(별칭: ls)	설치된 플러그인을 활성화/비활성화 상태로 나열합니다.

공급자 플러그인 선택 사항은 config.yaml에 저장됩니다.

• memory.provider — 활성 메모리 공급자(비어 있음 = 내장형만 해당)
• context.engine — 활성 컨텍스트 엔진("compressor" = 내장 기본값)

일반 플러그인 비활성화 목록은 plugins.disabled 아래의 config.yaml에 저장됩니다.

플러그인 및 Hermes 플러그인 빌드를 참조하세요.

hermes tools

hermes tools [--summary]

옵션	설명
--summary	현재 활성화된 도구 요약을 인쇄하고 종료합니다.

--summary이 없으면 대화형 플랫폼별 도구 구성 UI가 시작됩니다.

hermes computer-use

hermes computer-use <subcommand>

하위 명령:

하위 명령	설명
install	업스트림 cua-driver 설치 프로그램을 실행합니다(macOS에만 해당).
install --upgrade	cua-driver가 이미 PATH에 있더라도 설치 프로그램을 다시 실행하십시오. 업스트림 스크립트는 항상 최신 릴리스를 가져오므로 전체 업그레이드가 수행됩니다.
status	cua-driver이 $PATH에 있는지 여부와 설치된 버전을 인쇄합니다.

hermes computer-use install은 설치를 위한 안정적인 진입점입니다. cua-driver에서 사용되는 바이너리 computer_use 도구 세트. 동일한 업스트림 설치 프로그램을 실행합니다. hermes tools은 컴퓨터 사용을 처음 활성화할 때 호출되므로 안전합니다. 도구 세트 토글이 트리거되지 않은 경우 설치를 다시 실행하는 데 사용 (예를 들어 복귀 사용자 설정에서)

hermes update은 마지막에 업스트림 설치 프로그램을 자동으로 다시 실행합니다. cua-driver가 PATH에 있는 경우 업데이트를 수행하므로 대부분의 사용자는 그럴 필요가 없습니다. --upgrade을 수동으로 호출하세요. 원하는 수정 사항을 업스트림으로 배송할 때 사용하세요. 다음 헤르메스 업데이트를 기다리지 않고 지금 당장.

hermes sessions

hermes sessions <subcommand>

하위 명령:

하위 명령	설명
list	최근 세션을 나열합니다.
browse	검색 및 재개 기능이 있는 대화형 세션 선택기입니다.
export <output> [--session-id ID]	세션을 JSONL로 내보냅니다.
delete <session-id>	세션 하나를 삭제합니다.
prune	이전 세션을 삭제합니다.
stats	세션 저장소 통계를 표시합니다.
rename <session-id> <title>	세션 제목을 설정하거나 변경합니다.

hermes insights

hermes insights [--days N] [--source platform]

옵션	설명
--days <n>	지난 n일을 분석합니다(기본값: 30).
--source <platform>	cli, telegram 또는 discord와 같은 소스별로 필터링합니다.

hermes claw

hermes claw migrate [options]

OpenClaw 설정을 Hermes로 마이그레이션하세요. ~/.openclaw(또는 사용자 정의 경로)에서 읽고 ~/.hermes에 씁니다. 기존 디렉터리 이름(~/.clawdbot, ~/.moltbot) 및 구성 파일 이름(clawdbot.json, moltbot.json)을 자동으로 감지합니다.

옵션	설명
--dry-run	아무것도 쓰지 않고 마이그레이션될 항목을 미리 봅니다.
--preset <name>	마이그레이션 사전 설정: full(모든 호환 설정) 또는 user-data(인프라 구성 제외). 사전 설정은 비밀을 가져오지 않습니다. --migrate-secrets을 명시적으로 전달합니다.
--overwrite	충돌 시 기존 Hermes 파일을 덮어씁니다(기본값: 계획이 충돌할 때 적용을 거부함).
--migrate-secrets	마이그레이션에 API 키를 포함합니다. --preset full에서도 필요합니다.
--no-backup	~/.hermes/의 마이그레이션 전 zip 스냅샷을 건너뜁니다(기본적으로 단일 복원 지점 아카이브는 적용 전에 ~/.hermes/backups/pre-migration-*.zip에 기록되며 hermes import로 복원 가능).
--source <path>	사용자 정의 OpenClaw 디렉터리(기본값: ~/.openclaw).
--workspace-target <path>	작업 공간 지침의 대상 디렉터리(AGENTS.md)입니다.
--skill-conflict <mode>	스킬 이름 충돌 처리: skip(기본값), overwrite 또는 rename.
--yes	확인 메시지를 건너뜁니다.

마이그레이션되는 항목

마이그레이션에는 페르소나, 메모리, 기술, 모델 공급자, 메시징 플랫폼, 에이전트 동작, 세션 정책, MCP 서버, TTS 등의 30개 이상의 범주가 포함됩니다. 항목은 Hermes 해당 항목으로 직접 가져오거나 수동 검토를 위해 보관됩니다.

직접 가져옴: SOUL.md, MEMORY.md, USER.md, AGENTS.md, 기술(4개 소스 디렉터리), 기본 모델, 사용자 정의 공급자, MCP 서버, 메시징 플랫폼 토큰 및 허용 목록(Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), 에이전트 기본값(추론 노력, 압축, 인적 지연, 시간대, 샌드박스), 세션 재설정 정책, 승인 규칙, TTS 구성, 브라우저 설정, 도구 설정, 실행 시간 초과, 명령 허용 목록, 게이트웨이 구성, 3가지 소스의 API 키.

수동 검토를 위해 보관됨: 크론 작업, 플러그인, 후크/웹후크, 메모리 백엔드(QMD), 기술 레지스트리 구성, UI/ID, 로깅, 다중 에이전트 설정, 채널 바인딩, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.

API 키 확인은 우선순위에 따라 세 가지 소스(구성 값 → ~/.openclaw/.env → auth-profiles.json)를 확인합니다. 모든 토큰 필드는 일반 문자열, env 템플릿(${VAR}) 및 SecretRef 개체를 처리합니다.

전체 구성 키 매핑, SecretRef 처리 세부 정보 및 마이그레이션 후 체크리스트는 **전체 마이그레이션 가이드**를 참조하세요.

예

# Preview what would be migrated
hermes claw migrate --dry-run

# Full migration (all compatible settings, no secrets)
hermes claw migrate --preset full

# Full migration including API keys
hermes claw migrate --preset full --migrate-secrets

# Migrate user data only (no secrets), overwrite conflicts
hermes claw migrate --preset user-data --overwrite

# Migrate from a custom OpenClaw path
hermes claw migrate --source /home/user/old-openclaw

hermes dashboard

hermes dashboard [options]

구성, API 키, 모니터링 세션을 관리하기 위한 브라우저 기반 UI인 웹 대시보드를 시작하세요. pip install hermes-agent[web](FastAPI + Uvicorn)이 필요합니다. 전체 문서는 웹 대시보드를 참조하세요.

옵션	기본값	설명
--port	9119	웹서버를 실행하기 위한 포트
--host	127.0.0.1	바인딩 주소
--no-open	—	브라우저를 자동으로 열지 않음

# Default — opens browser to http://127.0.0.1:9119
hermes dashboard

# Custom port, no browser
hermes dashboard --port 8080 --no-open

hermes profile

hermes profile <subcommand>

프로필 관리 — 각각 고유한 구성, 세션, 기술 및 홈 디렉터리가 있는 여러 개의 격리된 Hermes 인스턴스입니다.

하위 명령	설명
list	모든 프로필을 나열합니다.
use <name>	고정 기본 프로필을 설정합니다.
create <name> [--clone] [--clone-all] [--clone-from <source>] [--no-alias]	새 프로필을 만듭니다. --clone은 활성 프로필에서 구성, .env 및 SOUL.md을 복사합니다. --clone-all은 모든 상태를 복사합니다. --clone-from은 소스 프로필을 지정합니다.
delete <name> [-y]	프로필을 삭제합니다.
show <name>	프로필 세부 정보(홈 디렉터리, 구성 등)를 표시합니다.
alias <name> [--remove] [--name NAME]	빠른 프로필 액세스를 위해 래퍼 스크립트를 관리합니다.
rename <old> <new>	프로필 이름을 바꿉니다.
export <name> [-o FILE]	프로필을 .tar.gz 아카이브로 내보냅니다(로컬 백업).
import <archive> [--name NAME]	.tar.gz 아카이브에서 프로필을 가져옵니다(로컬 복원).
install <source> [--name N] [--alias] [--force] [-y]	git URL 또는 로컬 디렉터리에서 프로필 배포를 설치합니다.
update <name> [--force-config] [-y]	배포판을 다시 가져옵니다. 사용자 데이터(메모리, 세션, 인증)를 보존합니다.
info <name>	프로필의 배포 매니페스트(버전, 요구 사항, 소스)를 표시합니다.

예:

hermes profile list
hermes profile create work --clone
hermes profile use work
hermes profile alias work --name h-work
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes profile install github.com/user/my-distro --alias
hermes profile update work
hermes -p work chat -q "Hello from work profile"

hermes completion

hermes completion [bash|zsh|fish]

쉘 완성 스크립트를 stdout으로 인쇄합니다. Hermes 명령, 하위 명령 및 프로필 이름의 탭 완성을 위해 셸 프로필에서 출력을 소싱합니다.

예:

# Bash
hermes completion bash >> ~/.bashrc

# Zsh
hermes completion zsh >> ~/.zshrc

# Fish
hermes completion fish > ~/.config/fish/completions/hermes.fish

hermes update

hermes update [--check] [--backup] [--restart-gateway]

최신 hermes-agent 코드를 가져와 venv에 종속성을 다시 설치한 다음 설치 후 후크(MCP 서버, 기술 동기화, 설치 완료)를 다시 실행합니다. 라이브 설치 시 실행해도 안전합니다.

pip 설치: hermes update은 pip 기반 설치를 자동으로 감지합니다. PyPI에 최신 릴리스를 쿼리하고 git pull 대신 pip install --upgrade hermes-agent을 실행합니다. PyPI 릴리스는 main의 모든 커밋이 아니라 태그가 지정된 버전(주/부 릴리스)을 추적합니다. 설치하지 않고도 최신 PyPI 릴리스를 사용할 수 있는지 확인하려면 --check을 사용하세요.

옵션	설명
--check	현재 커밋과 최신 origin/main 커밋을 나란히 인쇄하고 동기화 중인 경우 0을 종료하고 뒤쳐진 경우 1을 종료합니다. 아무것도 가져오거나 설치하거나 다시 시작하지 않습니다.
--backup	가져오기 전에 HERMES_HOME(구성, 인증, 세션, 기술, 페어링 데이터)의 레이블이 지정된 사전 업데이트 스냅샷을 생성하세요. 기본값은 해제입니다. 이전의 항상 백업 동작은 대규모 집의 모든 업데이트에 몇 분을 추가했습니다. config.yaml의 update.backup: true을 통해 영구적으로 켜세요.
--restart-gateway	업데이트가 성공적으로 완료되면 실행 중인 게이트웨이 서비스를 다시 시작합니다. 여러 프로필이 설치된 경우 --all 의미를 암시합니다.

추가 동작:

• 페어링 데이터 스냅샷. --backup이 꺼져 있는 경우에도 hermes update은 git pull 이전의 Feishu 댓글 규칙과 ~/.hermes/pairing/의 경량 스냅샷을 찍습니다. 편집 중인 파일을 끌어서 다시 쓰는 경우 hermes backup restore --state pre-update을 사용하여 롤백할 수 있습니다.
• 레거시 hermes.service 경고. Hermes가 사전 이름 변경 hermes.service systemd 유닛(현재 hermes-gateway.service 대신)을 감지하면 플랩 루프 문제를 방지할 수 있도록 일회성 마이그레이션 힌트를 인쇄합니다.
• 종료 코드. 성공 시 0, 풀/설치/설치 후 오류 시 1, git pull을 차단하는 예기치 않은 작업 트리 변경 시 2.

유지 관리 명령

명령	설명
hermes version	버전 정보를 인쇄합니다.
hermes update	최신 변경 사항을 가져오고 종속성을 다시 설치하세요.
hermes uninstall [--full] [--yes]	Hermes를 제거하고 선택적으로 모든 구성/데이터를 삭제합니다.

또한보십시오

• 슬래시 명령어 참고
• CLI 인터페이스
• 세션
• 스킬 시스템
• 스킨 및 테마