agenticros 0.3.1 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/README.md +8 -3
  2. package/dist/__tests__/hermes-config.test.d.ts +2 -0
  3. package/dist/__tests__/hermes-config.test.d.ts.map +1 -0
  4. package/dist/__tests__/hermes-config.test.js +88 -0
  5. package/dist/__tests__/hermes-config.test.js.map +1 -0
  6. package/dist/commands/doctor.d.ts.map +1 -1
  7. package/dist/commands/doctor.js +13 -0
  8. package/dist/commands/doctor.js.map +1 -1
  9. package/dist/commands/hermes.d.ts +14 -0
  10. package/dist/commands/hermes.d.ts.map +1 -0
  11. package/dist/commands/hermes.js +84 -0
  12. package/dist/commands/hermes.js.map +1 -0
  13. package/dist/commands/init.d.ts +2 -1
  14. package/dist/commands/init.d.ts.map +1 -1
  15. package/dist/commands/init.js +21 -1
  16. package/dist/commands/init.js.map +1 -1
  17. package/dist/index.js +19 -0
  18. package/dist/index.js.map +1 -1
  19. package/dist/util/hermes-config.d.ts +51 -0
  20. package/dist/util/hermes-config.d.ts.map +1 -0
  21. package/dist/util/hermes-config.js +277 -0
  22. package/dist/util/hermes-config.js.map +1 -0
  23. package/package.json +2 -1
  24. package/runtime/BUNDLE.json +1 -1
  25. package/runtime/README.md +87 -10
  26. package/runtime/docs/cli.md +49 -2
  27. package/runtime/packages/agenticros-claude-code/README.md +35 -0
package/runtime/packages/agenticros-claude-code/README.md CHANGED
@@ -136,6 +136,41 @@ Two Codex-specific notes:
136
136
  - **Absolute path required.** Codex's working directory at server-spawn time is not the AgenticROS repo root, so `args = ["packages/agenticros-claude-code/dist/index.js"]` will fail. Use the full absolute path.
137
137
  - **Project-scoped config.** Codex also supports a `.codex/config.toml` in a project directory (and a `mcp.json` in cwd on recent builds) — handy for per-repo MCP setups when you don't want `agenticros` enabled globally. See OpenAI's [Codex config reference](https://developers.openai.com/codex/config-reference) for the precedence rules.
138
138
 
139
+ ## Hermes Agent
140
+
141
+ The same MCP server works unmodified with **[Hermes Agent](https://github.com/NousResearch/hermes-agent)** — Hermes is a model-agnostic MCP client (OpenRouter, Ollama, Anthropic, OpenAI, 200+ providers).
142
+
143
+ **Option A — `agenticros hermes setup` (recommended)**
144
+
145
+ ```bash
146
+ agenticros hermes setup
147
+ agenticros hermes doctor
148
+ ```
149
+
150
+ **Option B — edit YAML directly**
151
+
152
+ ```yaml
153
+ # ~/.hermes/config.yaml
154
+ mcp_servers:
155
+ agenticros:
156
+ command: "node"
157
+ args: ["/ABSOLUTE/PATH/TO/agenticros/packages/agenticros-claude-code/dist/index.js"]
158
+ env:
159
+ AGENTICROS_ROBOT_NAMESPACE: ""
160
+ connect_timeout: 60
161
+ timeout: 120
162
+ ```
163
+
164
+ Then `/reload-mcp` in Hermes or restart the agent. Verify with `hermes mcp test agenticros`.
165
+
166
+ Hermes-specific notes:
167
+
168
+ - **Absolute path required.** Same as Codex — Hermes does not spawn MCP servers from the repo root.
169
+ - **Empty namespace.** Leave `AGENTICROS_ROBOT_NAMESPACE: ""` so `agenticros mode real|sim` drives the active robot (same policy as Codex).
170
+ - **Model choice is independent.** OpenRouter, Ollama, or any other Hermes LLM provider does not change AgenticROS MCP setup.
171
+
172
+ Full guide: [docs/hermes-setup.md](../../docs/hermes-setup.md).
173
+
139
174
  ## Claude desktop app + Claude Dispatch (iOS)
140
175
 
141
176
  The Claude **desktop** app uses a different MCP config file than Claude Code: