Skip to content

docs(hermes): correct plugin install path (#197)#205

Merged
rohitg00 merged 1 commit intomainfrom
fix/197-hermes-plugin-path
Apr 26, 2026
Merged

docs(hermes): correct plugin install path (#197)#205
rohitg00 merged 1 commit intomainfrom
fix/197-hermes-plugin-path

Conversation

@rohitg00
Copy link
Copy Markdown
Owner

@rohitg00 rohitg00 commented Apr 26, 2026

Summary

  • Hermes scans ~/.hermes/plugins/<name>/ flat-only for memory providers
  • memory/ category namespace is reserved for bundled providers, so user plugins nested under it are never discovered
  • Fix path in README and integrations/hermes/README.md from ~/.hermes/plugins/memory/agentmemory to ~/.hermes/plugins/agentmemory

Thanks @LehaoLin for the precise repro and source-pointer to plugins/memory/__init__.py.

Closes #197

Test plan

  • Cold-install on a fresh Hermes setup at ~/.hermes/plugins/agentmemory/
  • Verify memory.provider: agentmemory resolves on Hermes startup

Summary by CodeRabbit

Documentation

  • Updated Hermes integration setup instructions to reference a simplified plugin installation directory path, streamlining the configuration process and providing clearer guidance for users implementing the integration.

Hermes scans `~/.hermes/plugins/<name>/` flat. Memory category
namespace (`memory/`) is reserved for bundled providers and won't
discover user plugins nested under it.

Closes #197
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 26, 2026

📝 Walkthrough

Walkthrough

Documentation correction updating the Hermes plugin installation path from a nested directory structure (~/.hermes/plugins/memory/agentmemory) to a flat structure (~/.hermes/plugins/agentmemory) to align with Hermes' plugin discovery mechanism that only scans one level deep.

Changes

Cohort / File(s) Summary
Documentation Path Corrections
README.md, integrations/hermes/README.md
Updated Hermes integration installation instructions to use flat plugin directory layout (~/.hermes/plugins/agentmemory) instead of nested layout (~/.hermes/plugins/memory/agentmemory) for proper plugin discovery.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • PR #114: Edits the same Hermes integration README setup prompt for installation configuration.
  • PR #107: Introduced the original installation instruction now being corrected by this PR.

Poem

🐰 Hop from memory's nested hall,
To plugins flat—just one level tall!
Hermes scans but one layer deep,
So flat's the path our plugins keep! 🥕

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs(hermes): correct plugin install path (#197)' accurately describes the main change: correcting documentation for the Hermes plugin installation path.
Linked Issues check ✅ Passed The PR correctly addresses all coding requirements from issue #197: updating README.md and integrations/hermes/README.md to reflect the correct flat-layout plugin path ~/.hermes/plugins/agentmemory.
Out of Scope Changes check ✅ Passed All changes are directly related to correcting the plugin installation path documentation as specified in issue #197; no out-of-scope modifications are present.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/197-hermes-plugin-path

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@integrations/hermes/README.md`:
- Line 78: The package docstring in integrations/hermes/__init__.py still
references the old installation path "~/.hermes/plugins/memory/agentmemory/";
update that docstring string to match the README and use the correct
installation path "~/.hermes/plugins/agentmemory/" so documentation is
consistent (locate the top-level module docstring in
integrations/hermes/__init__.py and replace the old path substring).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 678f44dc-91ca-432b-9891-e07368ee9caa

📥 Commits

Reviewing files that changed from the base of the PR and between 18e3257 and 8042094.

📒 Files selected for processing (2)
  • README.md
  • integrations/hermes/README.md


```bash
cp -r integrations/hermes ~/.hermes/plugins/memory/agentmemory
cp -r integrations/hermes ~/.hermes/plugins/agentmemory
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Find all references to the old nested plugin path

# Search for the old nested path pattern
rg -n "\.hermes/plugins/memory/agentmemory" --type-add 'doc:*.{md,py,txt,yaml,yml}' --type doc

Repository: rohitg00/agentmemory

Length of output: 158


Update the installation path in integrations/hermes/__init__.py docstring.

The README correctly updates the installation path to ~/.hermes/plugins/agentmemory/, but the docstring in integrations/hermes/__init__.py (line 4) still references the old nested path: ~/.hermes/plugins/memory/agentmemory/.

Suggested fix
 """
 agentmemory memory provider for Hermes Agent.
 
-Drop this folder into ~/.hermes/plugins/memory/agentmemory/
+Drop this folder into ~/.hermes/plugins/agentmemory/
 or install via: hermes plugin install agentmemory
 
 Requires agentmemory server running: npx `@agentmemory/agentmemory`
 """
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@integrations/hermes/README.md` at line 78, The package docstring in
integrations/hermes/__init__.py still references the old installation path
"~/.hermes/plugins/memory/agentmemory/"; update that docstring string to match
the README and use the correct installation path
"~/.hermes/plugins/agentmemory/" so documentation is consistent (locate the
top-level module docstring in integrations/hermes/__init__.py and replace the
old path substring).

@rohitg00 rohitg00 merged commit 8f44c3d into main Apr 26, 2026
3 of 4 checks passed
@rohitg00 rohitg00 deleted the fix/197-hermes-plugin-path branch April 26, 2026 23:53
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.

[Docs] Hermes plugin installation path incorrect - should be ~/.hermes/plugins/agentmemory not ~/.hermes/plugins/memory/agentmemory

1 participant