슬래시 명령 참조

anchor alias

anchor alias

슬래시 명령 참조

Hermes에는 두 가지 슬래시 명령 표면이 있으며, 둘 다 hermes_cli/commands.py의 중앙 COMMAND_REGISTRY를 기반으로 동작합니다.

• 대화형 CLI 슬래시 명령 - cli.py가 dispatch하며, registry 기반 자동완성을 제공합니다.
• 메시징 슬래시 명령 - gateway/run.py가 dispatch하며, registry에서 생성된 도움말 텍스트와 플랫폼 메뉴를 사용합니다.

설치된 스킬도 두 표면 모두에서 동적 슬래시 명령으로 노출됩니다. 예를 들어 번들 스킬인 /plan은 plan mode를 열고, 활성 workspace/backend 작업 디렉터리를 기준으로 .hermes/plans/ 아래에 Markdown 계획을 저장합니다.

대화형 CLI 슬래시 명령

CLI에서 /를 입력하면 자동완성 메뉴가 열립니다. 내장 명령은 대소문자를 구분하지 않습니다.

세션

명령	설명
/new (alias: /reset)	새 세션을 시작합니다. 새 session ID와 대화 기록을 사용합니다.
/clear	화면을 지우고 새 세션을 시작합니다.
/history	대화 기록을 표시합니다.
/save	현재 대화를 저장합니다.
/retry	마지막 메시지를 다시 시도합니다. 에이전트에게 다시 보냅니다.
/undo	마지막 user/assistant 교환을 제거합니다.
/title	현재 세션 제목을 설정합니다. 사용 예: /title My Session Name
/compress [focus topic]	대화 컨텍스트를 수동으로 압축합니다. 메모리를 flush하고 요약을 생성합니다. 선택적 focus topic을 주면 요약에서 보존할 내용을 좁힙니다.
/rollback	파일 시스템 checkpoint를 나열하거나 복원합니다. 사용 예: /rollback [number]
/snapshot [create|restore <id>|prune] (alias: /snap)	Hermes 설정과 상태의 snapshot을 만들거나 복원합니다. create [label]은 snapshot을 저장하고, restore <id>는 해당 snapshot으로 되돌리며, prune [N]은 오래된 snapshot을 제거합니다. 인수 없이 실행하면 전체 목록을 보여줍니다.
/stop	실행 중인 모든 백그라운드 프로세스를 종료합니다.
/queue <prompt> (alias: /q)	현재 에이전트 응답을 중단하지 않고 다음 턴에 사용할 프롬프트를 대기열에 넣습니다.
/steer <prompt>	다음 도구 호출이 끝난 뒤 에이전트에 전달될 중간 실행 메모를 주입합니다. 중단하지 않고, 새 사용자 턴도 만들지 않습니다. 현재 도구가 끝나면 마지막 도구 결과 내용에 텍스트가 덧붙어 에이전트가 같은 tool-calling loop 안에서 새 맥락을 받습니다. 테스트 실행 중 "focus on the auth module"처럼 방향을 살짝 조정할 때 사용합니다.
/goal <text>	Hermes가 여러 턴에 걸쳐 달성하려고 할 상시 목표를 설정합니다. 각 턴 뒤 auxiliary judge 모델이 목표 완료 여부를 판단하고, 완료되지 않았으면 Hermes가 자동으로 계속 진행합니다. 하위 명령: /goal status, /goal pause, /goal resume, /goal clear. 기본 예산은 20턴(goals.max_turns)이며, 실제 사용자 메시지가 오면 continuation loop가 중단됩니다. 상태는 /resume 뒤에도 유지됩니다. 전체 흐름은 Persistent Goals를 참고하세요.
/resume [name]	이전에 이름을 붙인 세션을 다시 시작합니다.
/sessions	이전 세션을 대화형 picker로 찾아 다시 시작합니다.
/redraw	전체 UI를 다시 그립니다. tmux resize, 마우스 선택 흔적 등으로 터미널 표시가 어긋났을 때 복구에 사용합니다.
/status	세션 정보를 표시합니다.
/agents (alias: /tasks)	현재 세션 전반의 활성 에이전트와 실행 중인 작업을 표시합니다.
/background <prompt> (alias: /bg, /btw)	별도 백그라운드 세션에서 프롬프트를 실행합니다. 에이전트는 독립적으로 작업하고, 현재 세션은 다른 일에 사용할 수 있습니다. 작업이 끝나면 결과가 패널로 표시됩니다. CLI 백그라운드 세션을 참고하세요.
/branch [name] (alias: /fork)	현재 세션에서 분기해 다른 경로를 탐색합니다.
/handoff <platform>	CLI 전용. 현재 세션을 Telegram, Discord, Slack, WhatsApp, Signal, Matrix 같은 메시징 플랫폼으로 넘깁니다. 게이트웨이는 즉시 세션을 이어받고, thread를 지원하는 플랫폼에서는 새 thread를 만들며, 대상 채팅을 CLI session_id에 다시 연결해 기존 transcript를 재생합니다. 성공하면 CLI는 /resume 힌트와 함께 종료됩니다. 실행 중간에는 거부됩니다. 대상 플랫폼의 게이트웨이가 실행 중이어야 하고, 해당 플랫폼의 home channel이 /sethome으로 설정되어 있어야 합니다. Cross-Platform Handoff를 참고하세요.

설정

명령	설명
/config	현재 설정을 표시합니다.
/model [model-name]	현재 모델을 표시하거나 변경합니다. 지원 형식: /model claude-sonnet-4, /model provider:model, /model custom:model, /model custom:name:model, /model custom, 사용자 정의 별칭(/model fav, /model grok). 자세한 내용은 사용자 정의 모델 별칭을 참고하세요. --global을 붙이면 변경사항을 config.yaml에 저장합니다. 참고: /model은 이미 설정된 provider 사이에서만 전환할 수 있습니다. 새 provider를 추가하려면 세션을 종료하고 터미널에서 hermes model을 실행하세요.
/codex-runtime [auto|codex_app_server|on|off]	OpenAI/Codex 모델에 대한 선택적 Codex app-server runtime을 전환합니다. auto(기본값)는 Hermes의 표준 chat completions를 사용합니다. codex_app_server는 turn 처리를 codex app-server 하위 프로세스에 넘겨 native shell, apply_patch, ChatGPT subscription auth, migrated Codex plugin을 사용합니다. 다음 세션부터 적용됩니다.
/personality	미리 정의된 personality를 설정합니다.
/verbose	도구 진행 표시 모드를 off -> new -> all -> verbose 순서로 전환합니다. 설정을 통해 메시징에서도 활성화할 수 있습니다.
/fast [normal|fast|status]	Fast mode를 전환합니다. OpenAI Priority Processing 또는 Anthropic Fast Mode를 사용합니다. 옵션: normal, fast, status.
/reasoning	reasoning effort와 reasoning 표시를 관리합니다. 사용 예: /reasoning [level|show|hide]
/skin	표시 skin/theme를 보거나 변경합니다.
/statusbar (alias: /sb)	context/model status bar를 켜거나 끕니다.
/voice [on|off|tts|status]	CLI voice mode와 음성 재생을 전환합니다. 녹음은 voice.record_key를 사용합니다. 기본값은 Ctrl+B입니다.
/yolo	YOLO mode를 전환합니다. 위험한 명령에 대한 승인 프롬프트를 모두 건너뜁니다.
/footer [on|off|status]	최종 응답에 표시되는 gateway runtime metadata footer를 전환합니다. 모델, 도구 수, 타이밍이 표시됩니다.
/busy [queue|steer|interrupt|status]	CLI 전용. Hermes가 작업 중일 때 Enter 입력을 어떻게 처리할지 정합니다. 새 메시지를 queue에 넣거나, mid-turn steer로 전달하거나, 즉시 중단할 수 있습니다.
/indicator [kaomoji|emoji|unicode|ascii]	CLI 전용. TUI busy indicator 스타일을 선택합니다.

도구와 스킬

명령	설명
/tools [list|disable|enable] [name...]	도구를 관리합니다. 현재 세션에서 사용 가능한 도구를 나열하거나 특정 도구를 비활성화/활성화합니다. 도구를 비활성화하면 에이전트의 toolset에서 제거되고 세션 reset이 트리거됩니다.
/toolsets	사용 가능한 toolset을 나열합니다.
/browser [connect|disconnect|status]	로컬 Chrome CDP 연결을 관리합니다. connect는 실행 중인 Chrome 인스턴스(기본값 ws://localhost:9222)에 브라우저 도구를 붙입니다. disconnect는 연결을 해제하고, status는 현재 연결 상태를 표시합니다. 디버거가 감지되지 않으면 Chrome을 자동으로 시작합니다.
/skills	온라인 registry에서 스킬을 검색, 설치, 검사, 관리합니다.
/cron	예약 작업을 관리합니다. list, add/create, edit, pause, resume, run, remove를 지원합니다.
/curator	백그라운드 스킬 유지보수를 제어합니다. status, run, pin, archive를 지원합니다. Curator를 참고하세요.
/kanban <action>	채팅을 떠나지 않고 multi-profile, multi-project collaboration board를 조작합니다. 전체 hermes kanban 표면을 사용할 수 있습니다. 예: /kanban list, /kanban show t_abc, /kanban create "title" --assignee X, /kanban comment t_abc "text", /kanban unblock t_abc, /kanban dispatch. multi-board 명령도 포함됩니다. Kanban slash command를 참고하세요.
/reload-mcp (alias: /reload_mcp)	config.yaml에서 MCP 서버를 다시 로드합니다.
/reload-skills (alias: /reload_skills)	~/.hermes/skills/를 다시 스캔해 새로 설치되었거나 제거된 스킬을 반영합니다.
/reload	실행 중인 세션에 .env 변수를 다시 로드합니다. 재시작하지 않고 새 API 키를 반영할 때 사용합니다.
/plugins	설치된 플러그인과 상태를 나열합니다.

정보

명령	설명
/help	도움말 메시지를 표시합니다.
/usage	토큰 사용량, 비용 breakdown, 세션 시간, 그리고 활성 provider에서 제공할 수 있는 경우 Account limits 섹션을 표시합니다. 할당량, 크레딧, 플랜 사용량은 provider API에서 실시간으로 가져옵니다.
/insights	최근 30일 사용 인사이트와 분석을 표시합니다.
/platforms (alias: /gateway)	gateway/messaging 플랫폼 상태를 표시합니다.
/paste	클립보드 이미지를 첨부합니다.
/copy [number]	마지막 assistant 응답을 클립보드에 복사합니다. 숫자를 지정하면 뒤에서 N번째 응답을 복사합니다. CLI 전용입니다.
/image <path>	다음 프롬프트에 로컬 이미지 파일을 첨부합니다.
/debug	시스템 정보와 로그가 포함된 debug report를 업로드하고 공유 가능한 링크를 받습니다. 메시징에서도 사용할 수 있습니다.
/profile	활성 profile 이름과 home directory를 표시합니다.
/gquota	Google Gemini Code Assist 할당량 사용량을 progress bar로 표시합니다. google-gemini-cli provider가 활성화된 경우에만 사용할 수 있습니다.

종료

명령	설명
/quit	CLI를 종료합니다. /exit도 같은 동작입니다.

동적 CLI 슬래시 명령

명령	설명
/<skill-name>	설치된 스킬을 on-demand 명령으로 로드합니다. 예: /gif-search, /github-pr-workflow, /excalidraw.
/skills ...	registry와 공식 optional skills catalog에서 스킬을 검색, 탐색, 검사, 설치, audit, publish, 설정합니다.

빠른 명령

사용자 정의 quick command는 짧은 슬래시 명령을 셸 명령 또는 다른 슬래시 명령에 매핑합니다. ~/.hermes/config.yaml에서 설정합니다.

quick_commands:
  status:
    type: exec
    command: systemctl status hermes-agent
  deploy:
    type: exec
    command: scripts/deploy.sh
  inbox:
    type: alias
    target: /gmail unread

그런 다음 CLI나 메시징 플랫폼에서 /status, /deploy, /inbox를 입력합니다. quick command는 dispatch 시점에 해석되며, 모든 내장 자동완성/도움말 테이블에 표시되지는 않을 수 있습니다.

문자열만 들어 있는 prompt shortcut은 quick command로 지원되지 않습니다. 긴 재사용 프롬프트는 스킬에 넣거나, type: alias로 기존 슬래시 명령을 가리키게 하세요.

사용자 정의 모델 별칭

자주 쓰는 모델에 짧은 이름을 붙인 뒤, CLI 또는 메시징 플랫폼에서 /model <alias>로 사용할 수 있습니다. 별칭은 session-only 기본 동작과 --global 저장 동작에서 모두 동일하게 작동합니다.

두 가지 설정 형식을 지원합니다.

전체 형식 - 정확한 모델, provider, 선택적 base URL을 고정합니다. ~/.hermes/config.yaml에 넣습니다.

model_aliases:
  fav:
    model: claude-sonnet-4.6
    provider: anthropic
  grok:
    model: grok-4
    provider: x-ai
  ollama-qwen:
    model: qwen3-coder:30b
    provider: custom
    base_url: http://localhost:11434/v1

짧은 형식 - provider/model을 하나의 문자열로 지정합니다. YAML을 직접 편집하지 않고 셸에서 설정할 수 있습니다.

hermes config set model.aliases.fav anthropic/claude-opus-4.6
hermes config set model.aliases.grok x-ai/grok-4

채팅에서는 다음처럼 사용합니다.

/model fav            # session-only
/model grok --global  # also persists current-model change to config.yaml

사용자 별칭은 내장 짧은 이름보다 우선합니다. 따라서 sonnet, kimi, opus 같은 이름으로 별칭을 만들면 내장 별칭을 가립니다. 별칭 이름은 대소문자를 구분하지 않습니다.

별칭 해석

명령은 접두사 매칭을 지원합니다. 예를 들어 /h는 /help로, /mod는 /model로 해석됩니다. 접두사가 여러 명령과 매칭되어 모호하면 registry 순서상 첫 번째 명령이 선택됩니다. 전체 명령명과 등록된 alias는 항상 접두사 매칭보다 우선합니다.

메시징 슬래시 명령

메시징 게이트웨이는 Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant, Teams 채팅 안에서 다음 내장 명령을 지원합니다.

명령	설명
/new	새 대화를 시작합니다.
/reset	대화 기록을 초기화합니다.
/status	세션 정보를 표시합니다.
/stop	실행 중인 모든 백그라운드 프로세스를 종료하고 현재 에이전트 실행을 중단합니다.
/model [provider:model]	모델을 표시하거나 변경합니다. provider 전환(/model zai:glm-5), 사용자 지정 endpoint(/model custom:model), 이름 있는 사용자 지정 provider(/model custom:local:qwen), 자동 감지(/model custom), 사용자 정의 별칭(/model fav, /model grok)을 지원합니다. --global을 붙이면 config.yaml에 저장합니다. 참고: 이미 설정된 provider 사이에서만 전환할 수 있습니다. 새 provider를 추가하거나 API 키를 설정하려면 채팅 밖 터미널에서 hermes model을 실행하세요.
/codex-runtime [auto|codex_app_server|on|off]	선택적 Codex app-server runtime을 전환합니다. config.yaml의 model.openai_runtime에 저장하고 cached agent를 제거해 다음 메시지부터 새 runtime을 사용하게 합니다. 다음 세션부터 적용됩니다.
/personality [name]	세션에 personality overlay를 설정합니다.
/fast [normal|fast|status]	Fast mode를 전환합니다. OpenAI Priority Processing 또는 Anthropic Fast Mode를 사용합니다.
/retry	마지막 메시지를 다시 시도합니다.
/undo	마지막 교환을 제거합니다.
/sethome (alias: /set-home)	현재 채팅을 delivery용 플랫폼 home channel로 표시합니다.
/compress [focus topic]	대화 컨텍스트를 수동으로 압축합니다. 선택적 focus topic으로 요약 보존 범위를 좁힐 수 있습니다.
/topic [off|help|session-id]	Telegram DM 전용. 사용자가 직접 관리하는 multi-session topic mode를 관리합니다. /topic은 활성화하거나 상태를 표시하고, /topic off는 비활성화와 binding 삭제를 수행하며, /topic help는 사용법을 표시합니다. topic 안에서 /topic <session-id>를 실행하면 이전 세션을 복원합니다. Multi-session DM mode를 참고하세요.
/title [name]	세션 제목을 설정하거나 표시합니다.
/resume [name]	이전에 이름을 붙인 세션을 다시 시작합니다.
/usage	토큰 사용량, 예상 비용 breakdown, context window 상태, 세션 시간, 그리고 활성 provider가 제공할 때 남은 할당량/크레딧을 표시하는 Account limits 섹션을 보여줍니다.
/insights [days]	사용 분석을 표시합니다.
/reasoning [level|show|hide]	reasoning effort를 변경하거나 reasoning 표시를 전환합니다.
/voice [on|off|tts|join|channel|leave|status]	채팅에서 음성 응답을 제어합니다. join/channel/leave는 Discord voice-channel mode를 관리합니다.
/rollback [number]	파일 시스템 checkpoint를 나열하거나 복원합니다.
/background <prompt>	별도 백그라운드 세션에서 프롬프트를 실행합니다. 작업이 끝나면 결과가 같은 채팅으로 전달됩니다. Messaging Background Sessions를 참고하세요.
/queue <prompt> (alias: /q)	현재 실행을 중단하지 않고 다음 턴에 사용할 프롬프트를 대기열에 넣습니다.
/steer <prompt>	다음 도구 호출 이후 메시지를 주입합니다. 중단하지 않으며 새 턴으로 처리하지 않습니다. 모델은 다음 반복에서 이 메시지를 받아 처리합니다.
/goal <text>	Hermes가 여러 턴에 걸쳐 달성할 상시 목표를 설정합니다. judge 모델이 각 턴 뒤 완료 여부를 확인하며, 완료되지 않았으면 Hermes가 자동으로 계속합니다. 완료, pause/clear, 또는 턴 예산(기본 20)에 도달하면 멈춥니다. 하위 명령: /goal status, /goal pause, /goal resume, /goal clear. status/pause/clear는 에이전트 실행 중에도 안전하지만, 새 목표를 설정하려면 먼저 /stop이 필요합니다. Persistent Goals를 참고하세요.
/footer [on|off|status]	최종 응답의 runtime metadata footer를 전환합니다. 모델, 도구 수, 타이밍을 표시합니다.
/curator [status|run|pin|archive]	백그라운드 스킬 유지보수를 제어합니다.
/kanban <action>	채팅에서 multi-profile, multi-project collaboration board를 조작합니다. 인수 표면은 CLI와 같습니다. running-agent guard를 우회하므로 /kanban unblock t_abc, /kanban comment t_abc "...", /kanban list --mine, /kanban boards switch <slug> 등을 mid-turn에 사용할 수 있습니다. /kanban create ...는 새 작업의 terminal event를 원래 채팅에 자동 구독시킵니다. Kanban slash command를 참고하세요.
/reload-mcp (alias: /reload_mcp)	설정에서 MCP 서버를 다시 로드합니다.
/yolo	YOLO mode를 전환합니다. 위험한 명령 승인 프롬프트를 모두 건너뜁니다.
/commands [page]	모든 명령과 스킬을 페이지 단위로 탐색합니다.
/approve [session|always]	대기 중인 위험 명령을 승인하고 실행합니다. session은 현재 세션에만 적용되고, always는 영구 allowlist에 추가합니다.
/deny	대기 중인 위험 명령을 거부합니다.
/update	Hermes Agent를 최신 버전으로 업데이트합니다.
/restart	활성 실행을 정리한 뒤 게이트웨이를 정상적으로 재시작합니다. 게이트웨이가 다시 온라인이 되면 요청자의 채팅/thread에 확인 메시지를 보냅니다.
/debug	시스템 정보와 로그가 포함된 debug report를 업로드하고 공유 가능한 링크를 받습니다.
/help	메시징 도움말을 표시합니다.
/<skill-name>	설치된 스킬을 이름으로 호출합니다.

참고

• /skin, /snapshot, /gquota, /reload, /tools, /toolsets, /browser, /config, /cron, /skills, /platforms, /paste, /image, /statusbar, /plugins, /busy, /indicator, /redraw, /clear, /history, /save, /copy, /handoff, /quit은 CLI 전용 명령입니다.
• /verbose는 기본적으로 CLI 전용이지만, config.yaml에서 display.tool_progress_command: true를 설정하면 메시징 플랫폼에서도 활성화할 수 있습니다. 활성화되면 display.tool_progress 모드를 순환하고 설정에 저장합니다.
• /sethome, /update, /restart, /approve, /deny, /topic, /commands는 메시징 전용 명령입니다.
• /status, /background, /queue, /steer, /voice, /reload-mcp, /reload-skills, /rollback, /debug, /fast, /footer, /curator, /kanban, /sessions, /yolo는 CLI와 메시징 게이트웨이 모두에서 사용할 수 있습니다.
• /voice join, /voice channel, /voice leave는 Discord에서만 의미가 있습니다.