Hermes Agent를 설치한 후 hermes 프롬프트 command not found에 입력하면 아직 재설치하지 마세요. 가장 흔한 이유는 셸이 PATH를 재로드하지 않았거나, 다른 터미널 환경에서 명령을 실행했을 때입니다. 공식 설치 지침에는 설치 후 첫 단계로 "셸 재로드"가 나와 있습니다.
먼저 세 단계의 간단한 점검으로 시작하세요
source ~/.bashrc실행 또는 zsh를 사용한다면source ~/.zshrc실행할 수 있습니다.- 터미널을 다시 열고
which hermes실행하세요. 경로가 보이면 명령이 발동된 것입니다. hermes doctor실행해서 의존성, 구성, 누락된 항목을 검사하게 하세요.
아직도 어디를 찾아야 할지 모르겠어요
which hermes 여전히 비어 있다면, PATH에 작성된 설치 스크립트의 셸 구성 파일이 현재 터미널에서 읽히지 않았을 가능성이 큽니다. Linux, macOS, WSL2의 기본 셸이 다를 수 있으니, echo $SHELL 사용해 bash인지 zsh인지 확인한 후 해당 설정 파일을 변경하세요.
WSL2 사용자는 Windows 네이티브 PowerShell이 아닌 Linux 서브시스템에서 실행되고 있는지 확인해야 합니다. Hermes Agent는 공식적으로 네이티브 Windows를 지원하지 않으며, Windows 사용자는 설치 및 실행 전에 반드시 WSL2를 입력해야 합니다.
서두르지 말고 디렉터리를 삭제하고 재설치하세요
재설치는 보통 PATH 문제를 해결하지 못하고 기존 구성을 더 혼란스럽게 만들 수 있습니다. 올바른 순서는 셸을 다시 로드하고, 현재 터미널 환경을 확인한 후 hermes doctor를 실행하는 것입니다. 의사가 누락된 의존성이나 손상된 저장소를 확인할 때만 업데이트나 재설치를 고려합니다.
