Repository navigation
docs: add Hermes Agent install guide - #61
Open
thierrypdamiba wants to merge 4 commits into
Open
thierrypdamiba wants to merge 4 commits into
thierrypdamiba wants to merge 4 commits into
Conversation
Hermes Agent reads Agent Plugins packages and loads this plugin's skills and the MCP gateway; it does not run hooks, commands, or agents. Record that in the install guide and client tables. `hermes plugins install ArcadeAI/arcade-plugin` clones the repository root and finds no manifest, so the guide copies plugin/ into the Hermes plugins directory. Checked with Hermes 0.23.0 and plugin 0.9.2. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NLn9ctYYLRcUH55rFahjnF
Hermes signs in only to servers marked auth: oauth, and an Agent Plugins mcp.json cannot set that, so `hermes mcp login arcade` reports the server missing from config. A same-named entry in your own config replaces the plugin's and signs in. Checked on Hermes 0.23.0: sign-in completed and the gateway's tools registered. Also document the missing-MCP-SDK failure after a plugin install, and its fix. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NLn9ctYYLRcUH55rFahjnF
…an update Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
![arcade-plugin-bot[bot]](https://avatars.githubusercontent.com/u/153409375?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Cursor Bugbot reviewed 1331c7c with no findings, and check passed. Approved automatically because thierrypdamiba has write access.
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Linear ticket: none
What/why
Hermes Agent (Nous Research) reads Agent Plugins packages, so it can load this plugin's skills and the Arcade gateway, but a first install fails in a few quiet ways.
hermes plugins install ArcadeAI/arcade-pluginprints "Installed" and installs nothing, because the manifest lives inplugin/. The plugin'smcp.jsoncan't mark the gateway as OAuth, sohermes mcp login arcadesays the server isn't in config, and a sign-in that times out is saved disabled. This PR adds a Hermes guide that gets a user from a fresh Hermes to a signed-in gateway, with the fix for each of those, plus how to run several agents: one gateway per agent, per-agent identity, and Hermes approvals on gateway calls. To smoke test: followdocs/install/hermes.mdon Hermes 0.23.0, then ask "What apps can Arcade use?"Codebase changes
Docs only, no plugin or hook changes. New
docs/install/hermes.md: install by copyingplugin/, sign in through a same-namedhermes mcp add ... --auth oauthentry, add Hermes'smcpextra when the SDK is missing, recover a timed-out sign-in, restarthermes gatewayafter an update, run more than one agent, and gate gateway calls with Hermes approvals. Hermes rows added to the root README install table,docs/install/README.mdanddocs/support-matrix.md(skills and MCP yes; hooks, commands and agents no).Additional notes
Every step was hit and worked around on a real install while building a Hermes plugin on top of this one (ArcadeAI/arcade-for-hermes). Two items are Hermes behavior, not ours: subdirectory installs and OAuth in plugin
mcp.json. A root-level manifest here would makehermes plugins install ArcadeAI/arcade-pluginwork and drop the copy step. Do you want that as a follow-up PR?~ 🕷️ Anansi, Thierry's Agent
Note
Low Risk
Documentation-only changes with no plugin, hooks, or runtime code affected.
Overview
Adds Hermes Agent as a documented install target alongside existing clients.
A new
docs/install/hermes.mdwalks through a manual install (copyplugin/into the Hermes plugins dir becausehermes plugins installclones the repo root and misses the manifest), OAuth via a user-ownedhermes mcp add ... --auth oauthentry, optionalmcpextra, recovery from timed-out sign-in, gateway restart after updates, multi-agent / per-identity setup, and Hermes approvals on gateway tool calls.The root README,
docs/install/README.md, anddocs/support-matrix.mdget Hermes rows: skills and MCP gateway yes; hooks, commands, and subagent no.Reviewed by Cursor Bugbot for commit 1331c7c. Bugbot is set up for automated code reviews on this repo. Configure here.