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.
- package/README.md +15 -5
- package/dist/__tests__/codex-config.test.d.ts +2 -0
- package/dist/__tests__/codex-config.test.d.ts.map +1 -0
- package/dist/__tests__/codex-config.test.js +76 -0
- package/dist/__tests__/codex-config.test.js.map +1 -0
- package/dist/__tests__/hermes-config.test.d.ts +2 -0
- package/dist/__tests__/hermes-config.test.d.ts.map +1 -0
- package/dist/__tests__/hermes-config.test.js +88 -0
- package/dist/__tests__/hermes-config.test.js.map +1 -0
- package/dist/commands/codex.d.ts +18 -0
- package/dist/commands/codex.d.ts.map +1 -0
- package/dist/commands/codex.js +99 -0
- package/dist/commands/codex.js.map +1 -0
- package/dist/commands/doctor.d.ts.map +1 -1
- package/dist/commands/doctor.js +38 -1
- package/dist/commands/doctor.js.map +1 -1
- package/dist/commands/hermes.d.ts +14 -0
- package/dist/commands/hermes.d.ts.map +1 -0
- package/dist/commands/hermes.js +84 -0
- package/dist/commands/hermes.js.map +1 -0
- package/dist/commands/init.d.ts +3 -1
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +46 -1
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/skills.js +2 -2
- package/dist/commands/skills.js.map +1 -1
- package/dist/index.js +39 -0
- package/dist/index.js.map +1 -1
- package/dist/menu.js +1 -1
- package/dist/menu.js.map +1 -1
- package/dist/util/codex-config.d.ts +56 -0
- package/dist/util/codex-config.d.ts.map +1 -0
- package/dist/util/codex-config.js +326 -0
- package/dist/util/codex-config.js.map +1 -0
- package/dist/util/hermes-config.d.ts +51 -0
- package/dist/util/hermes-config.d.ts.map +1 -0
- package/dist/util/hermes-config.js +277 -0
- package/dist/util/hermes-config.js.map +1 -0
- package/package.json +4 -1
- package/runtime/BUNDLE.json +1 -1
- package/runtime/README.md +104 -14
- package/runtime/docs/cli.md +50 -3
- package/runtime/packages/agenticros-claude-code/README.md +53 -8
- package/runtime/packages/agenticros-claude-code/package.json +11 -1
- 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.
|
|
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",
|
package/runtime/BUNDLE.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"packedAt": "2026-
|
|
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/)** —
|
|
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
|
|
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
|
|
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
|
|
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,
|
|
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. `
|
|
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
|
-
|
|
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`.
|
|
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
|
|
package/runtime/docs/cli.md
CHANGED
|
@@ -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.
|
|
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. `
|
|
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
|
|
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
|
|
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
|
|
119
|
+
**Option C — direct edit of `~/.codex/config.toml`**
|
|
110
120
|
|
|
111
121
|
```toml
|
|
112
122
|
[mcp_servers.agenticros]
|
|
113
|
-
command = "
|
|
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 = "
|
|
129
|
+
AGENTICROS_ROBOT_NAMESPACE = ""
|
|
120
130
|
```
|
|
121
131
|
|
|
122
|
-
|
|
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 <
|
|
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
|
-
|
|
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.
|