Skip to content

docs: add a Hermes Agent guide - #24

Merged
sepehr-safari merged 1 commit into
mainfrom
docs/hermes-guide
Oct 14, 2026
Merged

sepehr-safari merged 1 commit into
mainfrom
docs/hermes-guide

Conversation

@sepehr-safari

Copy link
Copy Markdown
Contributor

A setup guide for Hermes Agent, alongside the ones for Cursor, Codex, VS Code and Gemini CLI.

  • wrap on ~/.hermes/config.yaml, which it reads from 0.4.0 and edits without losing comments.
  • The API key: Hermes hands a stdio server only a short list of safe variables plus the entry's env, so the key goes in ~/.hermes/.env and is named as ${TYPESAFE_API_KEY} in the entry.
  • The plugin from integrations/hermes/ (feat(hooks): screen the built-in tools of Cursor, VS Code and Hermes Agent agent-chaperone#89), which screens Hermes's own tools: install, enable, what a hold and a withheld result look like.
  • What it does not cover, starting with the fact that none of it has been checked in a live run of Hermes yet.

The guide is listed in src/data/guides.ts, so it reaches the index, the sitemap and llms.txt, and it is in the IndexNow list. The MCP guide and the Claude Code guide link to it. The Hermes facts come from its 0.16.0 source and docs: the environment filter in tools/mcp_tool_config.py, ${VAR} interpolation of the whole server entry, hermes plugins enable, hermes mcp test and hermes logs mcp.

Lint, format, spacing, typecheck and build pass.

Hermes keeps its MCP servers in YAML and hands a stdio server a filtered environment, so the key has to be named in the entry's env. The guide covers the wrap change, that env line, and the plugin that screens Hermes's own terminal, edits and fetches from 0.4.0, with what it does not cover. It is listed with the other guides and linked from the MCP and Claude Code guides.
@vercel

vercel Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
agentchaperone-dev Ready Ready Preview Oct 14, 2026 6:15pm UTC

@sepehr-safari
sepehr-safari merged commit dac28eb into main Oct 14, 2026
3 checks passed
@sepehr-safari
sepehr-safari deleted the docs/hermes-guide branch October 14, 2026 18:18

This branch was successfully deployed

1 active deployment
Preview — 308165ff Deployed Oct 14, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant