What should I do if Hermes Agent prompts command not found?

If you enter hermes prompt command not found after installing Hermes Agent, do not reinstall it yet. The most common reason is that the shell has not reloaded the PATH, or you have run the command in another terminal environment. The official installation instructions also list "reloading the shell" as the first step after installation.

Start with a three-step quick check

1. Execute source ~/.bashrc, or source ~/.zshrc if you use zsh.
2. Reopen a terminal and run which hermes. If you can see the path, the command has taken effect.
3. Run hermes doctor and let it check for dependencies, configurations, and missing items.

Still can't find where to look

If which hermes is still empty, it is likely that the shell configuration file of the installation script written to the PATH has not been read by the current terminal. The default shell for Linux, macOS, and WSL2 may not be the same, so use echo $SHELL to see if you are using bash or zsh, and then change the corresponding configuration file.

WSL2 users should also confirm that they are running in the Linux subsystem, not Windows native PowerShell. Hermes Agent officially does not support native Windows, and Windows users should enter WSL2 before installing and running it.

Don't rush to delete the directory and reinstall

Reinstalling usually does not solve the PATH problem and may make the existing configuration more confusing. The correct order is: reload the shell, confirm the current terminal environment, and run the hermes doctor. Only if the doctor checks for missing dependencies or corrupted repositories will consider performing an update or reinstall.