agenticros 0.3.0 → 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 (45) hide show
  1. package/README.md +15 -5
  2. package/dist/__tests__/codex-config.test.d.ts +2 -0
  3. package/dist/__tests__/codex-config.test.d.ts.map +1 -0
  4. package/dist/__tests__/codex-config.test.js +76 -0
  5. package/dist/__tests__/codex-config.test.js.map +1 -0
  6. package/dist/__tests__/hermes-config.test.d.ts +2 -0
  7. package/dist/__tests__/hermes-config.test.d.ts.map +1 -0
  8. package/dist/__tests__/hermes-config.test.js +88 -0
  9. package/dist/__tests__/hermes-config.test.js.map +1 -0
  10. package/dist/commands/codex.d.ts +18 -0
  11. package/dist/commands/codex.d.ts.map +1 -0
  12. package/dist/commands/codex.js +99 -0
  13. package/dist/commands/codex.js.map +1 -0
  14. package/dist/commands/doctor.d.ts.map +1 -1
  15. package/dist/commands/doctor.js +38 -1
  16. package/dist/commands/doctor.js.map +1 -1
  17. package/dist/commands/hermes.d.ts +14 -0
  18. package/dist/commands/hermes.d.ts.map +1 -0
  19. package/dist/commands/hermes.js +84 -0
  20. package/dist/commands/hermes.js.map +1 -0
  21. package/dist/commands/init.d.ts +3 -1
  22. package/dist/commands/init.d.ts.map +1 -1
  23. package/dist/commands/init.js +46 -1
  24. package/dist/commands/init.js.map +1 -1
  25. package/dist/commands/skills.js +2 -2
  26. package/dist/commands/skills.js.map +1 -1
  27. package/dist/index.js +39 -0
  28. package/dist/index.js.map +1 -1
  29. package/dist/menu.js +1 -1
  30. package/dist/menu.js.map +1 -1
  31. package/dist/util/codex-config.d.ts +56 -0
  32. package/dist/util/codex-config.d.ts.map +1 -0
  33. package/dist/util/codex-config.js +326 -0
  34. package/dist/util/codex-config.js.map +1 -0
  35. package/dist/util/hermes-config.d.ts +51 -0
  36. package/dist/util/hermes-config.d.ts.map +1 -0
  37. package/dist/util/hermes-config.js +277 -0
  38. package/dist/util/hermes-config.js.map +1 -0
  39. package/package.json +4 -1
  40. package/runtime/BUNDLE.json +1 -1
  41. package/runtime/README.md +104 -14
  42. package/runtime/docs/cli.md +50 -3
  43. package/runtime/packages/agenticros-claude-code/README.md +53 -8
  44. package/runtime/packages/agenticros-claude-code/package.json +11 -1
  45. package/runtime/packages/core/README.md +12 -2
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hermes-config.js","sourceRoot":"","sources":["../../src/util/hermes-config.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agenticros",
3
- "version": "0.3.0",
3
+ "version": "0.3.3",
4
4
  "type": "module",
5
5
  "description": "AgenticROS - agentic AI for ROS-powered robots. Single CLI to launch real-robot or simulated demos, manage configuration, and inspect status.",
6
6
  "keywords": [
@@ -10,6 +10,9 @@
10
10
  "ai",
11
11
  "agent",
12
12
  "claude",
13
+ "codex",
14
+ "hermes",
15
+ "openai",
13
16
  "openclaw",
14
17
  "gazebo",
15
18
  "simulation",
@@ -1,5 +1,5 @@
1
1
  {
2
- "packedAt": "2026-06-30T01:58:21.409Z",
2
+ "packedAt": "2026-07-04T16:56:29.644Z",
3
3
  "repo": "https://github.com/PlaiPin/agenticros",
4
4
  "note": "This directory is a snapshot of the agenticros monorepo source. `agenticros init` will copy it to ~/agenticros and run pnpm install + colcon build there.",
5
5
  "layout": {
package/runtime/README.md CHANGED
@@ -27,7 +27,8 @@ With AgenticROS, your robot can describe what it sees, follow intent ("go check
27
27
  - **[OpenClaw](https://openclaw.ai)** — Native gateway plugin with ROS 2 tools, commands, a config UI, a teleop web app, and a skill loader. The flagship integration.
28
28
  - **[NVIDIA NemoClaw](https://github.com/NVIDIA/NemoClaw)** — Run AgenticROS inside NemoClaw's OpenShell sandbox with policy-enforced egress and managed NVIDIA inference; ROS 2, RealSense, and rosbridge stay on the host while the plugin runs sandboxed.
29
29
  - **[Anthropic Claude](https://www.anthropic.com/claude)** — A single MCP server powers **Claude Code** (terminal), **Claude Desktop** (macOS / Windows), and **Claude Dispatch** (iOS, paired to your Mac). Ask Claude what your robot sees, and it answers with a live camera snapshot and depth reading.
30
- - **[OpenAI Codex CLI](https://developers.openai.com/codex/)** — The same MCP server registers cleanly via `codex mcp add agenticros node …/packages/agenticros-claude-code/dist/index.js`, or via a `[mcp_servers.agenticros]` entry in `~/.codex/config.toml`. Same 15 tools, same JSON shapes. Setup: [packages/agenticros-claude-code/README.md#codex-cli-openai](packages/agenticros-claude-code/README.md#codex-cli-openai).
30
+ - **[OpenAI Codex CLI](https://developers.openai.com/codex/)** — Same MCP server as Claude Code. One command registers Codex: `agenticros codex setup` (writes `~/.codex/config.toml` with an absolute path to the MCP binary). Full tool surface: missions, follow-me, find-object, memory. Setup guide: [docs/codex-setup.md](docs/codex-setup.md).
31
+ - **[Hermes Agent](https://github.com/NousResearch/hermes-agent)** — Model-agnostic agent gateway (OpenRouter, Ollama, 200+ providers) with MCP client support. Same MCP server as Codex: `agenticros hermes setup` writes `~/.hermes/config.yaml`. Setup guide: [docs/hermes-setup.md](docs/hermes-setup.md).
31
32
  - **[Google Gemini](https://ai.google.dev/)** — Standalone CLI that uses Gemini function calling against the same ROS 2 tools (no MCP required) — ideal for scripting and headless agents.
32
33
 
33
34
  AgenticROS is built so that new adapters (LangGraph, OpenAI, local models, voice stacks, etc.) can be added without touching the ROS 2 layer. The core transport and tool contract are platform-agnostic; adapters are thin shims that surface those tools to each agent runtime.
@@ -38,12 +39,14 @@ AgenticROS is built so that new adapters (LangGraph, OpenAI, local models, voice
38
39
 
39
40
  - **Core** (`packages/core`): Platform-agnostic ROS2 transport (rosbridge, Zenoh, local, WebRTC), config schema, and shared types. No dependency on any specific AI platform.
40
41
  - **Adapters** (`packages/agenticros`, and later others): Implement the contract for each AI platform. The OpenClaw adapter registers tools, commands, and HTTP routes with the OpenClaw gateway and uses the core for all ROS2 communication.
41
- - `**packages/agenticros-claude-code`** — MCP server for **Claude Code** (terminal), **Claude desktop** (macOS), and **Dispatch** (iOS paired to Mac). See [packages/agenticros-claude-code/README.md](packages/agenticros-claude-code/README.md).
42
+ - `**packages/agenticros-claude-code`** — MCP server for **Claude Code**, **Claude desktop**, **Dispatch**, **OpenAI Codex CLI**, and **Hermes Agent**. See [packages/agenticros-claude-code/README.md](packages/agenticros-claude-code/README.md), [docs/codex-setup.md](docs/codex-setup.md), and [docs/hermes-setup.md](docs/hermes-setup.md).
42
43
  - `**packages/agenticros-gemini`** — **Gemini CLI**: use Google Gemini to chat with your robot from the terminal (same ROS2 tools, no MCP). See [packages/agenticros-gemini/README.md](packages/agenticros-gemini/README.md).
43
44
 
44
45
  ```
45
46
  User (messaging app) → OpenClaw Gateway → AgenticROS OpenClaw plugin → Core → ROS2 robots
46
47
  Claude (Code / desktop / Dispatch) → agenticros MCP server → Core → ROS2 robots (Zenoh/rosbridge)
48
+ Codex CLI → agenticros MCP server → Core → ROS2 robots (Zenoh/rosbridge)
49
+ Hermes Agent → agenticros MCP server → Core → ROS2 robots (Zenoh/rosbridge)
47
50
  Gemini CLI → @agenticros/gemini (function calling) → Core → ROS2 robots
48
51
  ```
49
52
 
@@ -135,7 +138,7 @@ The first run launches the interactive menu:
135
138
  ? What would you like to do?
136
139
  Launch with real robot
137
140
  ❯ Launch with simulation
138
- First-time setup (workspace + OpenClaw plugin + API key)
141
+ First-time setup (workspace + OpenClaw plugin + Codex MCP + API key)
139
142
  Manage skills (2 registered, 0 available, 0 broken)
140
143
  Stop everything
141
144
  Doctor (health check)
@@ -143,7 +146,7 @@ The first run launches the interactive menu:
143
146
  Tail logs
144
147
  ```
145
148
 
146
- Pick **First-time setup** once (workspace + OpenClaw plugin + API key, all
149
+ Pick **First-time setup** once (workspace + OpenClaw plugin + optional Codex MCP + API key, all
147
150
  idempotent), then choose how you want to run:
148
151
 
149
152
  | You want to … | Pick |
@@ -153,14 +156,18 @@ idempotent), then choose how you want to run:
153
156
  | Demo a **simulated 6-DOF arm** (UR5e-shaped, per-joint position control) | **Launch with simulation → 6-DOF arm** |
154
157
 
155
158
  Once a stack is up, point any of the supported agents — OpenClaw, Claude Code,
156
- Claude Desktop / Dispatch, or Gemini CLI — at the same robot and start talking
159
+ OpenAI Codex, Hermes Agent, Claude Desktop / Dispatch, or Gemini CLI — at the same robot and start talking
157
160
  to it. The CLI tracks what it spawned (pidfiles + logs under `/tmp/agenticros-*`),
158
161
  so **Stop everything** cleanly tears the demo down.
159
162
 
160
163
  Prefer scripted invocations? Every menu item maps to a direct command:
161
164
 
162
165
  ```bash
163
- npx agenticros init # one-time workspace + plugin + API key
166
+ npx agenticros init # one-time workspace + plugin + Codex/Hermes MCP + API key
167
+ agenticros codex setup # register AgenticROS MCP for OpenAI Codex CLI
168
+ agenticros codex doctor # validate ~/.codex/config.toml
169
+ agenticros hermes setup # register AgenticROS MCP for Hermes Agent
170
+ agenticros hermes doctor # validate ~/.hermes/config.yaml
164
171
  agenticros up real # real robot stack
165
172
  agenticros up sim-amr # simulated AMR (Gazebo + RViz, headless on Jetson)
166
173
  agenticros up sim-arm # simulated 6-DOF arm
@@ -295,15 +302,15 @@ Full walkthrough, troubleshooting, and a "full-embed" alternative (ROS / RealSen
295
302
 
296
303
  ## Claude + AgenticROS (MCP)
297
304
 
298
- The same **AgenticROS MCP server** (`@agenticros/claude-code`) can drive the robot from **Claude Code** (terminal) or from the **Claude desktop app** on macOS (including **Claude Dispatch** on iPhone when paired to Claude on your Mac). Both use MCP; they use **different config files**.
305
+ The **AgenticROS MCP server** (`@agenticros/claude-code`) drives the robot from **Claude Code** (terminal) or from the **Claude desktop app** on macOS (including **Claude Dispatch** on iPhone when paired to Claude on your Mac). **OpenAI Codex CLI** uses the same server — see **[Codex + AgenticROS](#codex--agenticros-mcp)** below. Claude clients use **different config files** than Codex (`.mcp.json` / `claude_desktop_config.json` vs `.codex/config.toml`).
299
306
 
300
- Shared setup:
307
+ Shared MCP setup (Claude and Codex):
301
308
 
302
309
  1. **Build** (from repo root): `pnpm install && pnpm build`
303
310
  2. **AgenticROS config**: `~/.agenticros/config.json` — set `zenoh.routerEndpoint`, `robot.namespace`, `robot.cameraTopic`, etc. (see [packages/agenticros-claude-code/README.md](packages/agenticros-claude-code/README.md)).
304
311
  3. **Zenoh**: Run `zenohd` with the remote-api plugin (e.g. port 10000) — see `scripts/zenohd-agenticros.json5` or [docs/zenoh-agenticros.md](docs/zenoh-agenticros.md).
305
312
 
306
- Optional: override `robot.namespace` per MCP launch with env `**AGENTICROS_ROBOT_NAMESPACE`** (must match the robot’s topic namespace exactly; many setups use **no dashes** in the UUID segment).
313
+ Optional: override `robot.namespace` per MCP launch with env `**AGENTICROS_ROBOT_NAMESPACE`**. Prefer leaving it empty in MCP/Codex config so `agenticros mode real|sim` drives the active profile (see [docs/codex-setup.md](docs/codex-setup.md)).
307
314
 
308
315
  ### Claude Code CLI (terminal)
309
316
 
@@ -346,6 +353,77 @@ Example `mcpServers` entry (adjust the path and namespace to your machine):
346
353
 
347
354
  Full steps, permissions (`mcp__agenticros`), and troubleshooting are in **[packages/agenticros-claude-code/README.md](packages/agenticros-claude-code/README.md)**.
348
355
 
356
+ ## Codex + AgenticROS (MCP)
357
+
358
+ **OpenAI Codex CLI** is a standard MCP client — it uses the same `@agenticros/claude-code` server as Claude Code (missions, follow-me, find-object, memory, full ROS tool surface). No separate adapter package.
359
+
360
+ ### Quick setup
361
+
362
+ ```bash
363
+ pnpm install && pnpm build # or: npx agenticros init
364
+ agenticros codex setup # ~/.codex/config.toml (global)
365
+ agenticros codex setup --project # .codex/config.toml in repo root
366
+ agenticros codex doctor # validate absolute MCP path + namespace policy
367
+ ```
368
+
369
+ Start Codex in your project directory, run `/mcp` — you should see **agenticros** connected with the full tool list. Then ask e.g. “List ROS2 topics” or “What do you see?”
370
+
371
+ ### Config files
372
+
373
+ | File | Scope |
374
+ |------|--------|
375
+ | `~/.codex/config.toml` | Global — all Codex sessions |
376
+ | `<project>/.codex/config.toml` | Project — when Codex runs in that directory |
377
+
378
+ `agenticros codex setup` writes an **absolute path** to `packages/agenticros-claude-code/dist/index.js` (or the bundled MCP path after `npx agenticros init`). Relative paths fail because Codex does not spawn MCP servers from the repo root.
379
+
380
+ Leave `AGENTICROS_ROBOT_NAMESPACE = ""` in the Codex env block so `~/.agenticros/config.json` and `agenticros mode real|sim` drive the active robot (same policy as `.mcp.json`).
381
+
382
+ ### Manual registration
383
+
384
+ ```bash
385
+ codex mcp add agenticros -- node "$(pwd)/packages/agenticros-claude-code/dist/index.js"
386
+ ```
387
+
388
+ Use an absolute path if not run from the repo root.
389
+
390
+ ### Troubleshooting
391
+
392
+ - **`/mcp` does not list agenticros** → run `agenticros codex setup`; check `agenticros codex doctor`
393
+ - **Transport timeout** → bring up Zenoh/rosbridge or run `agenticros up sim-amr` / `agenticros up real`
394
+ - **Logs** → `/tmp/agenticros-mcp.log`
395
+
396
+ Full guide: **[docs/codex-setup.md](docs/codex-setup.md)**.
397
+
398
+ ## Hermes + AgenticROS (MCP)
399
+
400
+ **[Hermes Agent](https://github.com/NousResearch/hermes-agent)** is a model-agnostic MCP client — it uses the same `@agenticros/claude-code` server as Claude Code and Codex (missions, follow-me, find-object, memory, full ROS tool surface). No separate adapter package. Works with OpenRouter, Ollama, Anthropic, OpenAI, and 200+ other providers.
401
+
402
+ ### Quick setup
403
+
404
+ ```bash
405
+ pnpm install && pnpm build # or: npx agenticros init
406
+ agenticros hermes setup # ~/.hermes/config.yaml
407
+ agenticros hermes doctor # validate absolute MCP path + namespace policy
408
+ ```
409
+
410
+ In Hermes, run `/reload-mcp` or restart, then `hermes mcp test agenticros`. Ask e.g. “List ROS2 topics” or “What do you see?”
411
+
412
+ ### Config file
413
+
414
+ | File | Scope |
415
+ |------|--------|
416
+ | `~/.hermes/config.yaml` | Global — default Hermes profile |
417
+
418
+ `agenticros hermes setup` writes an **absolute path** to the MCP server and leaves `AGENTICROS_ROBOT_NAMESPACE: ""` so `agenticros mode real|sim` drives the active robot (same policy as Codex).
419
+
420
+ ### Troubleshooting
421
+
422
+ - **MCP tools missing** → run `agenticros hermes setup`; `/reload-mcp` in Hermes; check `agenticros hermes doctor`
423
+ - **Transport timeout** → bring up Zenoh/rosbridge or run `agenticros up sim-amr` / `agenticros up real`
424
+
425
+ Full guide: **[docs/hermes-setup.md](docs/hermes-setup.md)**.
426
+
349
427
  ## Gemini CLI
350
428
 
351
429
  Use **Google Gemini** to chat with your robot from the terminal (same ROS2 tools as Claude Code, no MCP).
@@ -361,7 +439,7 @@ See **[packages/agenticros-gemini/README.md](packages/agenticros-gemini/README.m
361
439
 
362
440
  ## Memory (optional)
363
441
 
364
- AgenticROS can give every adapter a **shared, persistent, cross-process** long-term memory so facts you teach the robot from one agent are immediately available in the others — Claude Desktop, Claude Code, Gemini CLI, OpenClaw chat. Off by default. Two backends:
442
+ AgenticROS can give every adapter a **shared, persistent, cross-process** long-term memory so facts you teach the robot from one agent are immediately available in the others — Claude Desktop, Claude Code, OpenAI Codex, Hermes Agent, Gemini CLI, OpenClaw chat. Off by default. Two backends:
365
443
 
366
444
  - **`local`** — zero deps, JSON-on-disk at `~/.agenticros/memory.json`, keyword + recency search. Enable with one config flag.
367
445
  - **`mem0`** — semantic search via the pure-Node [`mem0ai`](https://www.npmjs.com/package/mem0ai) package (`pnpm add mem0ai`); file-backed vector store at `~/.mem0/vector_store.db` (shared across all processes on the host, no server to run); embedder auto-detects Ollama (`http://localhost:11434`) → `OPENAI_API_KEY` → clear error.
@@ -377,17 +455,21 @@ pnpm add mem0ai
377
455
  ollama pull nomic-embed-text # ~270 MB embedder model
378
456
  ```
379
457
 
380
- Add `{ "memory": { "enabled": true, "backend": "mem0" } }` to `~/.agenticros/config.json` (or the OpenClaw config UI). Restart the gateway / MCP client. Then ask Claude Desktop *"remember that I have a RealSense D435i for eyes"* and ask OpenClaw *"what do I have for eyes?"* — same fact, both agents.
458
+ Add `{ "memory": { "enabled": true, "backend": "mem0" } }` to `~/.agenticros/config.json` (or the OpenClaw config UI). Restart the gateway / MCP client. Then ask Claude Desktop *"remember that I have a RealSense D435i for eyes"* and ask Codex or OpenClaw *"what do I have for eyes?"* — same fact, every agent.
381
459
 
382
460
  ## Skills
383
461
 
384
- AgenticROS **skills** are optional packages that add tools and behaviors to the plugin (e.g. `follow_robot`, `find_object`). They are loaded at OpenClaw gateway start. **[AgenticROS Skills](https://github.com/agenticros/agenticros-skills)** is a curated list — use it to discover skills for your robot and to submit your own.
462
+ AgenticROS **skills** are optional packages that add tools and behaviors to the plugin (e.g. `follow_person`, `find_object`). They are loaded at OpenClaw gateway start. Browse and install from **[skills.agenticros.com](https://skills.agenticros.com)**, or scaffold and publish your own with the CLI.
385
463
 
386
464
  ### Managing skills with the CLI
387
465
 
388
466
  The `agenticros skills` command (and the **Manage skills** menu entry) does everything for you: it scans the usual locations for clones, edits `~/.openclaw/openclaw.json`, refreshes the plugin manifest's `contracts.tools` allowlist, and reminds you to bounce the gateway.
389
467
 
390
468
  ```bash
469
+ # Install from the marketplace (owner/skill-id ref)
470
+ npx agenticros skills search follow
471
+ npx agenticros skills install chrismatthieu/followme
472
+
391
473
  agenticros skills # list registered + cloned-but-unregistered
392
474
  agenticros skills discover # interactive picker over candidates on disk
393
475
  agenticros skills add <path-or-name> # register a clone (path) or npm package
@@ -395,7 +477,15 @@ agenticros skills remove <id-or-name> # unregister
395
477
  agenticros skills sync # refresh OpenClaw contracts.tools allowlist
396
478
  ```
397
479
 
398
- A typical first-run looks like:
480
+ **Create and publish** a new skill:
481
+
482
+ ```bash
483
+ npx agenticros create-skill my-skill --template robot
484
+ cd agenticros-skill-my-skill && npm install && npm run dev
485
+ npx agenticros publish
486
+ ```
487
+
488
+ A typical manual install (without the marketplace) looks like:
399
489
 
400
490
  ```bash
401
491
  # clone whichever skills you want, anywhere near the repo
@@ -441,7 +531,7 @@ Per-skill behaviour lives under `config.skills.<skillId>` (e.g. `config.skills.f
441
531
 
442
532
  ### Contract & writing your own skill
443
533
 
444
- A skill is a Node package with an `"agenticros": { "id": "..." }` block in `package.json` and a `registerSkill(api, config, context)` export from `main`. Publish it to **[skills.agenticros.com](https://skills.agenticros.com)** so others can install it with `npx agenticros skills install <slug>`. See **[docs/skills.md](docs/skills.md)** for the full contract and **[agenticros-skill-followme](https://github.com/agenticros/agenticros-skill-followme)** as a reference template.
534
+ A skill is a Node package with an `"agenticros": { "id": "..." }` block in `package.json` and a `registerSkill(api, config, context)` export from `main`. Scaffold with `npx agenticros create-skill`, publish to **[skills.agenticros.com](https://skills.agenticros.com)** with `npx agenticros publish`, and install with `npx agenticros skills install <owner/skill-id>` (e.g. `chrismatthieu/followme`). See **[docs/skills.md](docs/skills.md)** for the full contract and **[agenticros-skill-followme](https://github.com/agenticros/agenticros-skill-followme)** ([marketplace listing](https://skills.agenticros.com/chrismatthieu/followme)) as a reference template.
445
535
 
446
536
  ## Strategy & vision
447
537
 
@@ -65,7 +65,9 @@ skipped (with a checkmark) when already done:
65
65
  4. OpenClaw plugin install (via `scripts/setup_gateway_plugin.sh`)
66
66
  5. Robot config (writes `~/.agenticros/config.json`)
67
67
  6. OpenAI API key (paste once → `scripts/configure_agenticros.sh`)
68
- 7. Final `agenticros doctor` summary
68
+ 7. Codex MCP config (optional — `agenticros codex setup` for `~/.codex/config.toml` and project `.codex/config.toml`)
69
+ 8. Hermes MCP config (optional — `agenticros hermes setup` for `~/.hermes/config.yaml`)
70
+ 9. Final `agenticros doctor` summary
69
71
 
70
72
  Pass `--force` to re-run every step regardless of state.
71
73
 
@@ -83,6 +85,43 @@ same report as a structured object for CI / scripting:
83
85
 
84
86
  Exits non-zero if any check is red.
85
87
 
88
+ Checks include MCP server build status, OpenClaw plugin health, **Codex MCP config**
89
+ (`~/.codex/config.toml` path and namespace policy), **Hermes MCP config**
90
+ (`~/.hermes/config.yaml`), and Codex / Hermes CLI presence on `PATH`.
91
+
92
+ ### `agenticros codex setup [--project]`
93
+
94
+ Register the AgenticROS MCP server for **OpenAI Codex CLI**:
95
+
96
+ | Flag | Effect |
97
+ |---|---|
98
+ | (default) | Writes `[mcp_servers.agenticros]` to `~/.codex/config.toml` |
99
+ | `--project` | Writes `.codex/config.toml` in the current repo root instead |
100
+
101
+ Uses an **absolute path** to the MCP server binary (`packages/agenticros-claude-code/dist/index.js` in workspace mode, or the bundled path after `npx agenticros init`). Sets `AGENTICROS_ROBOT_NAMESPACE = ""` so `agenticros mode real|sim` drives the active robot namespace.
102
+
103
+ Also offered as an optional step during `agenticros init`.
104
+
105
+ ### `agenticros codex doctor [--json]`
106
+
107
+ Validate Codex MCP configuration: global and (when in a workspace) project `.codex/config.toml`, MCP binary path, and namespace policy. Exits non-zero on red checks. With `--json`, emits structured output for scripting.
108
+
109
+ See **[docs/codex-setup.md](codex-setup.md)** for the full Codex onboarding guide.
110
+
111
+ ### `agenticros hermes setup`
112
+
113
+ Register the AgenticROS MCP server for **[Hermes Agent](https://github.com/NousResearch/hermes-agent)**:
114
+
115
+ Writes `mcp_servers.agenticros` to `~/.hermes/config.yaml` with an **absolute path** to the MCP server binary and `AGENTICROS_ROBOT_NAMESPACE: ""` so `agenticros mode real|sim` drives the active robot namespace.
116
+
117
+ Also offered as an optional step during `agenticros init`. After setup, run `/reload-mcp` in Hermes or `hermes mcp test agenticros`.
118
+
119
+ ### `agenticros hermes doctor [--json]`
120
+
121
+ Validate Hermes MCP configuration: `~/.hermes/config.yaml`, MCP binary path, and namespace policy. Exits non-zero on red checks. With `--json`, emits structured output for scripting.
122
+
123
+ See **[docs/hermes-setup.md](hermes-setup.md)** for the full Hermes onboarding guide.
124
+
86
125
  ### `agenticros status [--json]`
87
126
 
88
127
  Shows running components (camera / sim / mcp / rosbridge / openclaw-gateway)
@@ -111,6 +150,9 @@ Read or edit `~/.agenticros/config.json`. Actions:
111
150
  |---|---|---|
112
151
  | `~/.agenticros/config.json` | User | AgenticROS runtime config (transport mode, namespace, safety limits). |
113
152
  | `~/.agenticros/cli-state.json` | CLI | Last-used mode/namespace for the menu's "(yesterday)" hint. |
153
+ | `~/.hermes/config.yaml` | Hermes Agent | MCP server registrations (written by `agenticros hermes setup`). |
154
+ | `~/.codex/config.toml` | Codex CLI | MCP server registrations (written by `agenticros codex setup`). |
155
+ | `.codex/config.toml` | Codex CLI | Project-scoped MCP config (written by `agenticros codex setup --project`). |
114
156
  | `~/agenticros/` | CLI (npm-install mode) | Copy of the monorepo, with built dist + colcon install. |
115
157
  | `/tmp/agenticros-*.pid` | CLI | PIDs of background processes the CLI spawned. |
116
158
  | `/tmp/agenticros-*.log` | CLI | Stdout/stderr from those processes. |
@@ -134,13 +176,18 @@ Read or edit `~/.agenticros/config.json`. Actions:
134
176
  | `agenticros create-skill <slug> [--template hello\|robot\|camera\|depth]` | Scaffold `./agenticros-skill-<slug>/` in cwd. |
135
177
  | `agenticros skills dev [--invoke <tool>] [--live]` | Load the skill locally without OpenClaw. |
136
178
  | `agenticros publish [--graduate]` | Validate, push to GitHub, submit to skills.agenticros.com. |
137
- | `agenticros skills install <owner/skill>` | Install from marketplace (e.g. `agenticros/followme`). |
179
+ | `agenticros skills install <owner/skill>` | Install from marketplace (e.g. `chrismatthieu/followme`). |
138
180
  | `agenticros skills search <q>` | Search the marketplace. |
139
181
 
140
182
  ## Troubleshooting
141
183
 
142
184
  - **`doctor` shows red checks** → run `agenticros init` to walk through every
143
- step. Re-run `doctor` afterward.
185
+ step. Re-run `doctor` afterward. For Codex-specific issues, run
186
+ `agenticros codex doctor`. For Hermes, run `agenticros hermes doctor`.
187
+ - **Codex `/mcp` does not list agenticros** → run `agenticros codex setup`
188
+ (absolute MCP path required). See [codex-setup.md](codex-setup.md).
189
+ - **Hermes MCP tools missing** → run `agenticros hermes setup`, then `/reload-mcp`
190
+ in Hermes. See [hermes-setup.md](hermes-setup.md).
144
191
  - **`up` exits immediately** → `agenticros logs <component>` (the CLI now
145
192
  records where every child wrote its output) and read the error in context.
146
193
  - **`up sim-amr` warns "scripts/sim/run_sim.sh not found"** → simulation
@@ -96,9 +96,19 @@ Scope options: `--scope user` (default), `--scope project` (shared via `.mcp.jso
96
96
 
97
97
  ## Codex CLI (OpenAI)
98
98
 
99
- The same MCP server works unmodified with the **OpenAI Codex CLI** — Codex is a vanilla MCP client, and our server speaks the standard `2024-11-05` MCP protocol that every MCP-compatible client uses. Two ways to register it:
99
+ The same MCP server works unmodified with the **OpenAI Codex CLI** — Codex is a vanilla MCP client, and our server speaks the standard MCP protocol.
100
100
 
101
- **Option A — `codex mcp add` (recommended)**
101
+ **Option A — `agenticros codex setup` (recommended)**
102
+
103
+ ```bash
104
+ agenticros codex setup # ~/.codex/config.toml
105
+ agenticros codex setup --project # .codex/config.toml in repo root
106
+ agenticros codex doctor
107
+ ```
108
+
109
+ Then start Codex and run `/mcp` — you should see `agenticros` connected. See [docs/codex-setup.md](../../docs/codex-setup.md) for the full guide.
110
+
111
+ **Option B — `codex mcp add`**
102
112
 
103
113
  ```bash
104
114
  cd /path/to/agenticros
@@ -106,26 +116,61 @@ codex mcp add agenticros \
106
116
  -- node "$(pwd)/packages/agenticros-claude-code/dist/index.js"
107
117
  ```
108
118
 
109
- **Option B — direct edit of `~/.codex/config.toml`**
119
+ **Option C — direct edit of `~/.codex/config.toml`**
110
120
 
111
121
  ```toml
112
122
  [mcp_servers.agenticros]
113
- command = "node"
114
- args = ["/ABSOLUTE/PATH/TO/agenticros/packages/agenticros-claude-code/dist/index.js"]
123
+ command = "sh"
124
+ args = ["-c", "node /ABSOLUTE/PATH/TO/agenticros/packages/agenticros-claude-code/dist/index.js 2>>/tmp/agenticros-mcp.log"]
115
125
  enabled = true
116
126
  startup_timeout_sec = 30
117
127
 
118
128
  [mcp_servers.agenticros.env]
119
- AGENTICROS_ROBOT_NAMESPACE = "robotYOUR_NAMESPACE_NO_DASHES"
129
+ AGENTICROS_ROBOT_NAMESPACE = ""
120
130
  ```
121
131
 
122
- Then start a Codex session and run `/mcp` to verify — you should see `agenticros` connected with **15 tools** (more if you have skills like `agenticros-skill-followme` or `agenticros-skill-find` registered). Same tools, same tool names, same JSON shapes as in Claude Code; everything in the **Tools** section below applies identically.
132
+ Same tools, same tool names, same JSON shapes as in Claude Code; everything in the **Tools** section below applies identically.
123
133
 
124
134
  Two Codex-specific notes:
125
135
 
126
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.
127
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.
128
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
+
129
174
  ## Claude desktop app + Claude Dispatch (iOS)
130
175
 
131
176
  The Claude **desktop** app uses a different MCP config file than Claude Code:
@@ -300,4 +345,4 @@ If `ros2_publish` runs but the robot doesn’t move:
300
345
 
301
346
  ## Skills
302
347
 
303
- Skill packages (e.g. `agenticros-skill-followme`, `agenticros-skill-find`) extend the capability registry with new verbs like `follow_person` and `find_object`. The MCP server reads each skill's `package.json` `agenticros` block (`id`, `capabilities[]`) at startup and surfaces those verbs through `ros2_list_capabilities` and `run_mission` — no per-skill MCP tool needed. To register a skill for this adapter, install it with `agenticros skills install <slug>` from the marketplace, or add its path under `skillPaths[]` in `~/.agenticros/config.json` (or use the `agenticros skills add <path>` CLI). See [docs/skills.md](../../docs/skills.md) for the full skill contract.
348
+ Skill packages (e.g. `agenticros-skill-followme`, `agenticros-skill-find`) extend the capability registry with new verbs like `follow_person` and `find_object`. The MCP server reads each skill's `package.json` `agenticros` block (`id`, `capabilities[]`) at startup and surfaces those verbs through `ros2_list_capabilities` and `run_mission` — no per-skill MCP tool needed. To register a skill for this adapter, install it with `agenticros skills install <owner/skill-id>` from the marketplace (e.g. `chrismatthieu/followme`), or add its path under `skillPaths[]` in `~/.agenticros/config.json` (or use the `agenticros skills add <path>` CLI). See [docs/skills.md](../../docs/skills.md) for the full skill contract.
@@ -2,7 +2,17 @@
2
2
  "name": "@agenticros/claude-code",
3
3
  "version": "0.0.1",
4
4
  "type": "module",
5
- "description": "AgenticROS MCP server for Claude Code CLI — chat with your ROS2 robot from the terminal",
5
+ "description": "AgenticROS MCP server for Claude Code, Claude Desktop, Dispatch, and OpenAI Codex CLI — chat with your ROS2 robot from the terminal",
6
+ "keywords": [
7
+ "agenticros",
8
+ "ros2",
9
+ "robotics",
10
+ "mcp",
11
+ "claude",
12
+ "codex",
13
+ "openai",
14
+ "model-context-protocol"
15
+ ],
6
16
  "main": "./dist/index.js",
7
17
  "bin": {
8
18
  "agenticros-mcp": "./dist/index.js"
@@ -21,6 +21,16 @@ You don't normally use it directly — you use one of the adapters that depends
21
21
 
22
22
  A skill is an npm package that registers tools the AI agent can call on your robot.
23
23
 
24
+ **Quick start** — scaffold, dev locally, publish:
25
+
26
+ ```bash
27
+ npx agenticros create-skill my-skill
28
+ cd agenticros-skill-my-skill && npm install && npm run dev
29
+ npx agenticros publish
30
+ ```
31
+
32
+ Or start from scratch with `@agenticros/core`:
33
+
24
34
  ```bash
25
35
  npm install --save @agenticros/core
26
36
  ```
@@ -75,10 +85,10 @@ export const registerSkill: RegisterSkill = (api, _config, _context) => {
75
85
  };
76
86
  ```
77
87
 
78
- Submit your skill to the marketplace at **[skills.agenticros.com/submit](https://skills.agenticros.com/submit)** sign in with GitHub, paste your repo URL, and your skill becomes installable with:
88
+ Publish to the marketplace with `npx agenticros publish`, or submit via **[skills.agenticros.com/submit](https://skills.agenticros.com/submit)**. Published skills use namespaced refs `owner/skill-id` (your GitHub login + `agenticros.id`):
79
89
 
80
90
  ```bash
81
- npx agenticros skills install myskill
91
+ npx agenticros skills install your-handle/myskill
82
92
  ```
83
93
 
84
94
  See the [skills contract & guide](https://github.com/agenticros/agenticros/blob/main/docs/skills.md) for the full reference.