Skip to content

Agents

Excellent in Hermes Agent, as one entry in its own config

The installer writes one excellent entry into ~/.hermes/config.yaml, in YAML, under mcp_servers, and leaves the rest of the file alone. Restart Hermes Agent afterwards: it only sees the new server after a restart.

curl -fsSL https://excellent.so/install.sh | sh

It runs excellent install-agent-mcps, which writes the entry and prints Hermes Agent: linked.

The entry and the setup prompt

~/.hermes/config.yaml
mcp_servers:
excellent:
command: "/absolute/path/to/node"
cwd: "/absolute/path/to/@excellent-so/cli/dist"
args:
- "/absolute/path/to/@excellent-so/cli/dist/server.js"
env: {}
Setup prompt · paste it into Hermes Agent
Set up Excellent (excellent.so) in Hermes Agent for me. First run: curl -fsSL https://excellent.so/install.sh | sh
If its output has a line starting "Hermes Agent: linked" or "Hermes Agent: already-linked", skip to the last step.
Otherwise add this to ~/.hermes/config.yaml (create the file if it is missing). If the file already has a top-level mcp_servers: map, put the excellent: entry inside it; keep everything else unchanged:
mcp_servers:
  excellent:
    command: "/absolute/path/to/node"
    cwd: "/absolute/path/to/@excellent-so/cli/dist"
    args:
      - "/absolute/path/to/@excellent-so/cli/dist/server.js"
    env: {}
Replace /absolute/path/to/node with the output of `node -p process.execPath`, and /absolute/path/to/@excellent-so/cli/dist with the output of `echo "$(npm root -g)/@excellent-so/cli/dist"`.
Last step: tell me to restart Hermes Agent, because it only sees the new server after a restart.

It runs the installer and looks for Hermes Agent: linked; if that line is missing it adds the entry by hand, then asks you to restart.

Agent
Hermes AgentNous Research
Config file
~/.hermes/config.yamlmacOS
Linux, Windows
Linux: the same path. Windows: %USERPROFILE%\.hermes\config.yamlNot supported yet
Format
YAML, under mcp_serversmcp_servers, in YAML
Detected by
the hermes binary
The installer prints
Hermes Agent: linked
Restart
Restart Hermes Agent afterwards: it only sees the new server after a restart.
Undo
Delete the excellent: entry under mcp_servers: in ~/.hermes/config.yaml, then restart Hermes Agent.
Source
micro packages/core/src/agent-clis.ts:671
Hermes Agent docs

The CLI on npm today, 0.1.0 (checked October 23, 2026), predates install-agent-mcps: the installer skips this step, says so, and changes no agent config. Paste the setup prompt, or add the entry by hand as the setup doc shows.

Put Excellent in your agent: install it, restart the agent, run one task

Names and marks belong to their owners. Shown to say Excellent works with these agents, with no endorsement implied.