CLI
개요
Hermes CLI는 Hermes Agent를 실행하고 세션을 이어 가는 기본 통로입니다. 처음에는 자주 쓰는 명령만 익히면 됩니다. 설치 확인, 모델 설정, 대화 시작, 단발성 질문, 세션 재개 순서로 보면 충분합니다.
macOS, Linux, Windows WSL2는 bash 또는 zsh 명령을 중심으로 다룹니다. Windows native PowerShell은 별도 블록으로 제공합니다. 같은 명령처럼 보여도 셸이 다르면 경로 표기와 환경 변수 확인 방식이 달라집니다.
설치 확인
macOS, Linux, WSL2에서는 실행 파일이 잡혔는지 먼저 확인합니다.
command -v hermes
hermes --helpPowerShell에서는 다음 명령을 사용합니다.
Get-Command hermes
hermes --helphermes --help가 열리면 CLI를 사용할 준비가 된 것입니다.
모델 설정
첫 대화 전에 사용할 프로바이더와 모델을 정합니다.
hermes setup
hermes modelNous Portal을 쓰는 경우에는 아래 명령으로 포털 연결 상태를 확인합니다.
hermes setup --portal
hermes portal statusPowerShell에서도 같은 흐름을 사용합니다.
hermes setup
hermes model대화 시작
기본 대화형 CLI는 다음 명령으로 엽니다.
hermes터미널 UI를 사용하려면 다음 명령을 실행합니다.
hermes --tui처음에는 짧은 요청으로 동작을 확인합니다.
현재 디렉터리를 5줄로 요약해줘.단발성 질문
대화형 화면을 열지 않고 한 번만 질문하려면 hermes chat -q를 사용합니다.
hermes chat -q "현재 폴더의 README 파일을 3줄로 요약해줘."PowerShell:
hermes chat -q "현재 폴더의 README 파일을 3줄로 요약해줘."이 방식은 스크립트나 점검 명령에 붙이기 좋습니다. 다만 파일 수정처럼 확인이 필요한 작업은 대화형 모드에서 진행하는 편이 안전합니다.
세션 재개
최근 대화를 다시 열려면 --continue를 사용합니다.
hermes --continue짧은 형태도 지원합니다.
hermes -c특정 세션 ID를 알고 있다면 --resume으로 지정합니다.
hermes --resume 20260225_143052_a1b2c3PowerShell:
hermes --continue
hermes --resume 20260225_143052_a1b2c3작업 폴더 기준 잡기
Hermes Agent는 실행한 위치를 중요한 작업 맥락으로 봅니다. 프로젝트를 맡길 때는 먼저 저장소 루트로 이동한 뒤 실행합니다.
cd ~/projects/my-app
pwd
hermesPowerShell:
Set-Location C:\projects\my-app
Get-Location
hermes여러 브랜치나 폴더를 나누어 작업할 때는 각 작업 폴더에서 세션을 따로 여는 편이 좋습니다.
Worktree 모드
Git worktree를 나누어 작업하는 경우에는 별도 작업 공간에서 Hermes를 실행합니다. 이때 hermes -w를 사용해 현재 작업 폴더 기준의 격리된 흐름을 열 수 있습니다.
pwd
hermes -w단발성 질문과 함께 쓸 수도 있습니다.
hermes -w -q "현재 worktree의 변경 파일을 요약해줘."PowerShell에서는 먼저 위치를 확인한 뒤 실행합니다.
Get-Location
hermes -wworktree 안에서 실패가 발생하면 Hermes 문제가 아니라 Git 작업 폴더가 꼬인 경우도 있습니다. 이때는 현재 브랜치와 저장소 루트를 먼저 확인한 뒤 다시 실행합니다.
자주 쓰는 순서
macOS, Linux, WSL2:
command -v hermes
hermes --help
hermes setup
hermes model
hermes
hermes --continuePowerShell:
Get-Command hermes
hermes --help
hermes setup
hermes model
hermes
hermes --continue여기까지 되면 CLI 실행, 모델 설정, 첫 대화, 세션 재개를 모두 확인한 것입니다. 이후에는 작업 폴더를 바꾸거나 worktree를 나누기 전에 이 기본 묶음이 계속 통과하는지 먼저 봅니다.
막힐 때
--continue가 빈 대화처럼 보이면 같은 사용자 계정과 같은 작업 폴더에서 실행했는지 확인합니다.--tui화면이 깨지면 일반hermes모드로 먼저 확인합니다.- 파일을 찾지 못하면 Hermes를 실행한 현재 폴더가 프로젝트 루트인지 확인합니다.
- 모델 응답이 오지 않으면
hermes model로 프로바이더와 모델을 다시 고릅니다. - Windows에서 실패가 반복되면 Windows native PowerShell 대신 Windows WSL2에서 같은 순서로 다시 확인합니다.
다음 글
기본 실행 흐름을 확인했다면 첫 번째 대화로 넘어갑니다. 여기서 대화형 CLI와 세션 재개를 다시 잡은 뒤, 다음 장에서 도구와 기억을 이어서 봅니다.