본문으로 건너뛰기

슬래시 명령 참조

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.
/reasoningreasoning 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입니다.
/yoloYOLO 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를 표시합니다.
/gquotaGoogle Gemini Code Assist 할당량 사용량을 progress bar로 표시합니다. google-gemini-cli provider가 활성화된 경우에만 사용할 수 있습니다.

종료​

명령설명
/quitCLI를 종료합니다. /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 서버를 다시 로드합니다.
/yoloYOLO mode를 전환합니다. 위험한 명령 승인 프롬프트를 모두 건너뜁니다.
/commands [page]모든 명령과 스킬을 페이지 단위로 탐색합니다.
/approve [session|always]대기 중인 위험 명령을 승인하고 실행합니다. session은 현재 세션에만 적용되고, always는 영구 allowlist에 추가합니다.
/deny대기 중인 위험 명령을 거부합니다.
/updateHermes 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에서만 의미가 있습니다.