Merge branch 'main' of github.com:NousResearch/hermes-agent into bb/gui

2026-05-04 12:47:53 -05:00
parent 27c5fa5381 0ce1b9fe20
commit ca8f2c7907
182 changed files with 9843 additions and 974 deletions
@@ -282,7 +282,16 @@ The dashboard embeds the real `hermes --tui` — **not** a rewrite.  See `hermes

 ## Adding New Tools

-Requires changes in **2 files**:
+For most custom or local-only tools, do **not** edit Hermes core. Use the plugin
+route instead: create `~/.hermes/plugins/<name>/plugin.yaml` and
+`~/.hermes/plugins/<name>/__init__.py`, then register tools with
+`ctx.register_tool(...)`. Plugin toolsets are discovered automatically and can be
+enabled or disabled without touching `tools/` or `toolsets.py`.
+
+Use the built-in route below only when the user is explicitly contributing a new
+core Hermes tool that should ship in the base system.
+
+Built-in/core tools require changes in **2 files**:

 **1. Create `tools/your_tool.py`:**
 ```python