agenticros 0.3.1 → 0.3.4

package/README.md

@@ -3,14 +3,14 @@
 > agentic AI for ROS-powered robots
 
 `agenticros` is the unified command-line tool for AgenticROS — bring up a real
-robot or a simulated one, drive it from Claude Code, OpenAI Codex, or OpenClaw,
+robot or a simulated one, drive it from Claude Code, OpenAI Codex, Hermes Agent, or OpenClaw,
 and keep your workspace healthy from a single binary.
 
 ```bash
 # Brand new machine: one command end-to-end
-npx agenticros init     # workspace + plugin + Codex MCP + API key + doctor
+npx agenticros init     # workspace + plugin + MCP clients + API key + doctor
 agenticros              # interactive menu
-agenticros codex setup  # register AgenticROS MCP for OpenAI Codex CLI
+agenticros mcp setup    # register AgenticROS MCP for Codex, Hermes, and Claude
 agenticros up real      # bring up the real-robot stack
 agenticros up sim-amr   # bring up a simulated 2-wheel AMR
 agenticros up sim-arm   # bring up a simulated 6-DOF arm
@@ -54,8 +54,14 @@ Three ways, listed easiest first:
 | `agenticros up sim-arm` | Bring up the simulated 6-DOF arm (UR5e-shaped, per-joint position control). |
 | `agenticros down` | Stop everything we started. |
 | `agenticros doctor` | Coloured health-check table; `--json` for CI. |
-| `agenticros codex setup` | Register AgenticROS MCP in `~/.codex/config.toml` (or `--project`). |
+| `agenticros mcp setup` | Register AgenticROS MCP for Codex, Hermes, and Claude (primary). |
+| `agenticros mcp doctor` | Validate all MCP client configs. |
+| `agenticros codex setup` | Codex only — `~/.codex/config.toml` (or `--project`). |
 | `agenticros codex doctor` | Validate Codex MCP config paths and namespace policy. |
+| `agenticros hermes setup` | Hermes only — `~/.hermes/config.yaml`. |
+| `agenticros hermes doctor` | Validate Hermes MCP config paths and namespace policy. |
+| `agenticros claude setup` | Claude only — Desktop + project `.mcp.json`. |
+| `agenticros claude doctor` | Validate Claude MCP config paths and namespace policy. |
 | `agenticros status` | Snapshot of running components + last mode. |
 | `agenticros logs [target]` | Tail `camera` / `mcp` / `sim` / `rosbridge` / `gateway`. |
 | `agenticros config [show\|set\|edit\|reset]` | Read or edit `~/.agenticros/config.json`. |
@@ -77,7 +83,8 @@ walks through:
 5. Robot config (namespace, transport mode, sample `~/.agenticros/config.json`)
 6. OpenAI API key (paste once → `scripts/configure_agenticros.sh`)
 7. Codex MCP config (optional — `~/.codex/config.toml` and project `.codex/config.toml`)
-8. Final `agenticros doctor` summary
+8. Hermes MCP config (optional — `~/.hermes/config.yaml`)
+9. Final `agenticros doctor` summary
 
 Every step is **idempotent**: it checks doctor first and skips the work if
 nothing is missing. Use `agenticros init --force` to redo everything.
@@ -87,6 +94,7 @@ nothing is missing. Use `agenticros init --force` to redo everything.
 - `~/.agenticros/config.json` — AgenticROS runtime config (transport mode,
   robot namespace, safety limits, teleop defaults). Edited via `agenticros config`.
 - `~/.codex/config.toml` — OpenAI Codex CLI MCP servers (written by `agenticros codex setup`).
+- `~/.hermes/config.yaml` — Hermes Agent MCP servers (written by `agenticros hermes setup`).
 - `~/.agenticros/cli-state.json` — CLI's own state (last mode, last namespace,
   for the menu's "(yesterday)" hint).
 - `~/agenticros/` — the install dir when invoked via `npx`. Contains a copy of

package/dist/__tests__/claude-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-config.test.d.ts.map

package/dist/__tests__/claude-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/claude-config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/claude-config.test.js

@@ -0,0 +1,77 @@
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { buildAgenticrosMcpServerEntry, readClaudeAgenticrosConfig, upsertAgenticrosMcpJson, validateClaudeAgenticrosConfig, } from "../util/claude-config.js";
+describe("claude-config", () => {
+    it("buildAgenticrosMcpServerEntry uses sh -c wrapper and empty namespace", () => {
+        const entry = buildAgenticrosMcpServerEntry("/opt/agenticros/dist/index.js");
+        assert.equal(entry["type"], "stdio");
+        assert.equal(entry["command"], "sh");
+        assert.deepEqual(entry["args"], [
+            "-c",
+            "node /opt/agenticros/dist/index.js 2>>/tmp/agenticros-mcp.log",
+        ]);
+        assert.deepEqual(entry["env"], { AGENTICROS_ROBOT_NAMESPACE: "" });
+    });
+    it("upsertAgenticrosMcpJson preserves other servers", () => {
+        const existing = JSON.stringify({
+            mcpServers: {
+                other: { type: "stdio", command: "echo" },
+                agenticros: { type: "stdio", command: "node", args: ["old.js"] },
+            },
+        });
+        const entry = buildAgenticrosMcpServerEntry("/abs/index.js");
+        const merged = upsertAgenticrosMcpJson(existing, entry);
+        const parsed = JSON.parse(merged);
+        assert.ok(parsed.mcpServers.other);
+        assert.match(JSON.stringify(parsed.mcpServers.agenticros), /\/abs\/index.js/);
+    });
+    it("readClaudeAgenticrosConfig parses sh -c args", () => {
+        const dir = mkdtempSync(join(tmpdir(), "agenticros-claude-"));
+        const path = join(dir, ".mcp.json");
+        writeFileSync(path, JSON.stringify({
+            mcpServers: {
+                agenticros: {
+                    type: "stdio",
+                    command: "sh",
+                    args: ["-c", "node /tmp/index.js 2>>/tmp/agenticros-mcp.log"],
+                    env: { AGENTICROS_ROBOT_NAMESPACE: "" },
+                },
+            },
+        }));
+        const cfg = readClaudeAgenticrosConfig(path, "project");
+        assert.equal(cfg.command, "sh");
+        assert.deepEqual(cfg.args, ["-c", "node /tmp/index.js 2>>/tmp/agenticros-mcp.log"]);
+        assert.equal(cfg.env?.["AGENTICROS_ROBOT_NAMESPACE"], "");
+    });
+    it("validateClaudeAgenticrosConfig flags relative paths and hardcoded namespace", () => {
+        const cfg = {
+            configPath: "/tmp/.mcp.json",
+            exists: true,
+            target: "project",
+            command: "sh",
+            args: ["-c", "node packages/agenticros-claude-code/dist/index.js"],
+            env: { AGENTICROS_ROBOT_NAMESPACE: "robotabc" },
+        };
+        const v = validateClaudeAgenticrosConfig(cfg, "/abs/index.js");
+        assert.equal(v.ok, false);
+        assert.ok(v.issues.some((i) => i.message.includes("relative")));
+        assert.ok(v.issues.some((i) => i.message.includes("hardcoded")));
+    });
+    it("validateClaudeAgenticrosConfig passes for correct absolute config", () => {
+        const cfg = {
+            configPath: "/tmp/.mcp.json",
+            exists: true,
+            target: "project",
+            command: "sh",
+            args: ["-c", "node /abs/index.js 2>>/tmp/agenticros-mcp.log"],
+            env: { AGENTICROS_ROBOT_NAMESPACE: "" },
+        };
+        const v = validateClaudeAgenticrosConfig(cfg, "/abs/index.js");
+        assert.equal(v.ok, true);
+        assert.equal(v.issues.length, 0);
+    });
+});
+//# sourceMappingURL=claude-config.test.js.map

package/dist/__tests__/claude-config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-config.test.js","sourceRoot":"","sources":["../../src/__tests__/claude-config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAElC,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,KAAK,GAAG,6BAA6B,CAAC,+BAA+B,CAAC,CAAC;QAC7E,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;YAC9B,IAAI;YACJ,+DAA+D;SAChE,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,0BAA0B,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9B,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE;gBACzC,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE;aACjE;SACF,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,6BAA6B,CAAC,eAAe,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,uBAAuB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4C,CAAC;QAC7E,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACpC,aAAa,CACX,IAAI,EACJ,IAAI,CAAC,SAAS,CAAC;YACb,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE,CAAC,IAAI,EAAE,+CAA+C,CAAC;oBAC7D,GAAG,EAAE,EAAE,0BAA0B,EAAE,EAAE,EAAE;iBACxC;aACF;SACF,CAAC,CACH,CAAC;QACF,MAAM,GAAG,GAAG,0BAA0B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAC,CAAC;QACpF,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,GAAG,GAAG;YACV,UAAU,EAAE,gBAAgB;YAC5B,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,SAAkB;YAC1B,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,CAAC,IAAI,EAAE,oDAAoD,CAAC;YAClE,GAAG,EAAE,EAAE,0BAA0B,EAAE,UAAU,EAAE;SAChD,CAAC;QACF,MAAM,CAAC,GAAG,8BAA8B,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC/D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1B,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,GAAG,GAAG;YACV,UAAU,EAAE,gBAAgB;YAC5B,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,SAAkB;YAC1B,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,CAAC,IAAI,EAAE,+CAA+C,CAAC;YAC7D,GAAG,EAAE,EAAE,0BAA0B,EAAE,EAAE,EAAE;SACxC,CAAC;QACF,MAAM,CAAC,GAAG,8BAA8B,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC/D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/hermes-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hermes-config.test.d.ts.map

package/dist/__tests__/hermes-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hermes-config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/hermes-config.test.js

@@ -0,0 +1,88 @@
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { buildAgenticrosMcpYamlBlock, readHermesAgenticrosConfig, upsertAgenticrosBlock, validateHermesAgenticrosConfig, } from "../util/hermes-config.js";
+describe("hermes-config", () => {
+    it("buildAgenticrosMcpYamlBlock uses absolute path and empty namespace", () => {
+        const block = buildAgenticrosMcpYamlBlock("/opt/agenticros/dist/index.js");
+        assert.match(block, /args: \["\/opt\/agenticros\/dist\/index.js"\]/);
+        assert.match(block, /AGENTICROS_ROBOT_NAMESPACE: ""/);
+        assert.match(block, /connect_timeout: 60/);
+        assert.match(block, /timeout: 120/);
+    });
+    it("upsertAgenticrosBlock replaces existing agenticros section", () => {
+        const existing = `llm:
+  provider: openrouter
+
+mcp_servers:
+  other:
+    command: "echo"
+  agenticros:
+    command: "node"
+    args: ["relative/path.js"]
+    env:
+      AGENTICROS_ROBOT_NAMESPACE: "robot123"
+`;
+        const block = buildAgenticrosMcpYamlBlock("/abs/index.js");
+        const merged = upsertAgenticrosBlock(existing, block);
+        assert.match(merged, /llm:/);
+        assert.match(merged, /other:/);
+        assert.match(merged, /\/abs\/index.js/);
+        assert.doesNotMatch(merged, /relative\/path\.js/);
+        assert.match(merged, /AGENTICROS_ROBOT_NAMESPACE: ""/);
+    });
+    it("upsertAgenticrosBlock appends mcp_servers when missing", () => {
+        const existing = "llm:\n  provider: ollama\n";
+        const block = buildAgenticrosMcpYamlBlock("/abs/index.js");
+        const merged = upsertAgenticrosBlock(existing, block);
+        assert.match(merged, /mcp_servers:/);
+        assert.match(merged, /\/abs\/index.js/);
+    });
+    it("readHermesAgenticrosConfig parses stdio args and env", () => {
+        const dir = mkdtempSync(join(tmpdir(), "agenticros-hermes-"));
+        const path = join(dir, "config.yaml");
+        writeFileSync(path, `mcp_servers:
+  agenticros:
+    command: "node"
+    args: ["/tmp/index.js"]
+    env:
+      AGENTICROS_ROBOT_NAMESPACE: ""
+    connect_timeout: 60
+    timeout: 120
+`);
+        const cfg = readHermesAgenticrosConfig(path);
+        assert.equal(cfg.command, "node");
+        assert.deepEqual(cfg.args, ["/tmp/index.js"]);
+        assert.equal(cfg.env?.["AGENTICROS_ROBOT_NAMESPACE"], "");
+        assert.equal(cfg.connectTimeout, 60);
+        assert.equal(cfg.timeout, 120);
+    });
+    it("validateHermesAgenticrosConfig flags relative paths and hardcoded namespace", () => {
+        const cfg = {
+            configPath: "/tmp/config.yaml",
+            exists: true,
+            command: "node",
+            args: ["packages/agenticros-claude-code/dist/index.js"],
+            env: { AGENTICROS_ROBOT_NAMESPACE: "robotabc" },
+        };
+        const v = validateHermesAgenticrosConfig(cfg, "/abs/index.js");
+        assert.equal(v.ok, false);
+        assert.ok(v.issues.some((i) => i.message.includes("relative")));
+        assert.ok(v.issues.some((i) => i.message.includes("hardcoded")));
+    });
+    it("validateHermesAgenticrosConfig passes for correct absolute config", () => {
+        const cfg = {
+            configPath: "/tmp/config.yaml",
+            exists: true,
+            command: "node",
+            args: ["/abs/index.js"],
+            env: { AGENTICROS_ROBOT_NAMESPACE: "" },
+        };
+        const v = validateHermesAgenticrosConfig(cfg, "/abs/index.js");
+        assert.equal(v.ok, true);
+        assert.equal(v.issues.length, 0);
+    });
+});
+//# sourceMappingURL=hermes-config.test.js.map

package/dist/__tests__/hermes-config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-config.test.js","sourceRoot":"","sources":["../../src/__tests__/hermes-config.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/mcp-setup.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-setup.test.d.ts.map

package/dist/__tests__/mcp-setup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-setup.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mcp-setup.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/mcp-setup.test.js

@@ -0,0 +1,23 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { buildMcpDoctorChecks, resolveMcpHosts } from "../util/mcp-setup.js";
+describe("mcp-setup", () => {
+    it("resolveMcpHosts defaults to all three hosts", () => {
+        assert.deepEqual(resolveMcpHosts({}), ["codex", "hermes", "claude"]);
+    });
+    it("resolveMcpHosts honors explicit host flags", () => {
+        assert.deepEqual(resolveMcpHosts({ codex: true, hermes: false, claude: false }), ["codex"]);
+        assert.deepEqual(resolveMcpHosts({ hermes: true }), ["hermes"]);
+        assert.deepEqual(resolveMcpHosts({ claude: true }), ["claude"]);
+    });
+    it("resolveMcpHosts uses project scope for legacy codex setup", () => {
+        assert.deepEqual(resolveMcpHosts({ codexScope: "project" }), ["codex"]);
+    });
+    it("buildMcpDoctorChecks filters by host", () => {
+        const all = buildMcpDoctorChecks("/abs/index.js", "/repo");
+        const codexOnly = buildMcpDoctorChecks("/abs/index.js", "/repo", ["codex"]);
+        assert.ok(all.length > codexOnly.length);
+        assert.ok(codexOnly.every((c) => c.id.startsWith("codex")));
+    });
+});
+//# sourceMappingURL=mcp-setup.test.js.map

package/dist/__tests__/mcp-setup.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-setup.test.js","sourceRoot":"","sources":["../../src/__tests__/mcp-setup.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE7E,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5F,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,oBAAoB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,oBAAoB,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5E,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/claude.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `agenticros claude` — thin wrapper around unified MCP setup (Claude hosts).
+ */
+import { claudeOnPath } from "../util/mcp-setup.js";
+export interface ClaudeSetupOptions {
+    project?: boolean;
+    desktop?: boolean;
+    quiet?: boolean;
+}
+export interface ClaudeDoctorOptions {
+    json?: boolean;
+}
+export { claudeOnPath };
+export declare function claudeSetupCommand(opts?: ClaudeSetupOptions): Promise<void>;
+export declare function claudeDoctorCommand(opts?: ClaudeDoctorOptions): Promise<number>;
+//# sourceMappingURL=claude.d.ts.map

package/dist/commands/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/commands/claude.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAqC,MAAM,sBAAsB,CAAC;AAGvF,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAerF;AAED,wBAAsB,mBAAmB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAMzF"}

package/dist/commands/claude.js

@@ -0,0 +1,30 @@
+/**
+ * `agenticros claude` — thin wrapper around unified MCP setup (Claude hosts).
+ */
+import { header } from "../util/logger.js";
+import { claudeOnPath, mcpDoctorCommand, mcpSetupCommand } from "../util/mcp-setup.js";
+import { getCliPaths } from "../util/paths.js";
+export { claudeOnPath };
+export async function claudeSetupCommand(opts = {}) {
+    const paths = getCliPaths();
+    const desktopOnly = opts.desktop && !opts.project;
+    const projectOnly = opts.project && !opts.desktop;
+    await mcpSetupCommand({
+        codex: false,
+        hermes: false,
+        claude: true,
+        all: false,
+        project: projectOnly || (!desktopOnly && !!paths.repoRoot),
+        desktop: desktopOnly || !projectOnly,
+        repoRoot: paths.repoRoot,
+        quiet: opts.quiet,
+    });
+}
+export async function claudeDoctorCommand(opts = {}) {
+    if (!opts.json) {
+        header("Claude MCP doctor");
+    }
+    const paths = getCliPaths();
+    return mcpDoctorCommand({ json: opts.json, hosts: ["claude"], repoRoot: paths.repoRoot });
+}
+//# sourceMappingURL=claude.js.map

package/dist/commands/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/commands/claude.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAY/C,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA2B,EAAE;IACpE,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAElD,MAAM,eAAe,CAAC;QACpB,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,KAAK;QACV,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC1D,OAAO,EAAE,WAAW,IAAI,CAAC,WAAW;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAA4B,EAAE;IACtE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,OAAO,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/dist/commands/codex.d.ts

@@ -1,18 +1,18 @@
 /**
- * `agenticros codex` — configure OpenAI Codex CLI to use the AgenticROS MCP server.
+ * `agenticros codex` — thin wrapper around unified MCP setup (Codex host).
  */
 import { type CodexConfigScope } from "../util/codex-config.js";
+import { codexOnPath } from "../util/mcp-setup.js";
+export type { CodexConfigScope };
 export interface CodexSetupOptions {
     scope?: CodexConfigScope;
-    /** Skip interactive confirmation when codex CLI is missing. */
     yes?: boolean;
-    /** Suppress the section header (e.g. when called from `agenticros init`). */
     quiet?: boolean;
 }
 export interface CodexDoctorOptions {
     json?: boolean;
 }
-export declare function codexOnPath(): Promise<boolean>;
+export { codexOnPath };
 export declare function codexSetupCommand(opts?: CodexSetupOptions): Promise<void>;
 export declare function codexDoctorCommand(opts?: CodexDoctorOptions): Promise<number>;
 //# sourceMappingURL=codex.d.ts.map

package/dist/commands/codex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/commands/codex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EACL,KAAK,gBAAgB,EAOtB,MAAM,yBAAyB,CAAC;AAKjC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAOpD;AAED,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCnF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDvF"}
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/commands/codex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAqC,MAAM,sBAAsB,CAAC;AAEtF,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBnF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvF"}

package/dist/commands/codex.js

@@ -1,99 +1,30 @@
 /**
- * `agenticros codex` — configure OpenAI Codex CLI to use the AgenticROS MCP server.
+ * `agenticros codex` — thin wrapper around unified MCP setup (Codex host).
  */
-import { execa } from "execa";
-import { globalCodexConfigPath, projectCodexConfigPath, readCodexAgenticrosConfig, resolveCodexConfigPath, validateCodexAgenticrosConfig, writeCodexAgenticrosConfig, } from "../util/codex-config.js";
-import { findMcpEntry } from "../util/mcp-discovery.js";
-import { getCliPaths } from "../util/paths.js";
-import { colors, header, info, ok, warn, err } from "../util/logger.js";
-export async function codexOnPath() {
-    try {
-        const { exitCode } = await execa("codex", ["--version"], { reject: false });
-        return exitCode === 0;
-    }
-    catch {
-        return false;
-    }
-}
+import { header } from "../util/logger.js";
+import { codexOnPath, mcpDoctorCommand, mcpSetupCommand } from "../util/mcp-setup.js";
+export { codexOnPath };
 export async function codexSetupCommand(opts = {}) {
-    if (!opts.quiet) {
-        header("Configure Codex MCP");
-    }
-    const mcpEntry = findMcpEntry();
-    if (!mcpEntry) {
-        err("AgenticROS MCP server is not built.");
-        info("Run `pnpm --filter @agenticros/claude-code build` or `agenticros init` first.");
-        process.exit(1);
-    }
     const scope = opts.scope ?? "global";
-    const configPath = resolveCodexConfigPath(scope);
-    writeCodexAgenticrosConfig(configPath, mcpEntry, { namespace: "" });
-    ok(`Wrote Codex MCP config (${scope}): ${configPath}`);
-    info(`MCP server: ${mcpEntry}`);
-    const hasCodex = await codexOnPath();
-    if (hasCodex) {
-        info("Codex CLI detected. Verify in a Codex session with `/mcp` — you should see `agenticros` connected.");
-    }
-    else {
-        warn("Codex CLI not found on PATH.");
-        info("Install from https://developers.openai.com/codex/ then run `/mcp` in a Codex session.");
-    }
-    if (scope === "global") {
-        dimHint("Tip: for a repo-scoped config instead, run `agenticros codex setup --project` from the project root.");
-    }
+    if (scope === "project") {
+        await mcpSetupCommand({
+            codex: true,
+            codexScope: "project",
+            quiet: opts.quiet,
+        });
+        return;
+    }
+    await mcpSetupCommand({
+        codex: true,
+        hermes: false,
+        claude: false,
+        quiet: opts.quiet,
+    });
 }
 export async function codexDoctorCommand(opts = {}) {
-    const paths = getCliPaths();
-    const mcpEntry = findMcpEntry();
-    const candidates = [
-        { label: "global", path: globalCodexConfigPath() },
-    ];
-    if (paths.repoRoot) {
-        candidates.push({ label: "project", path: projectCodexConfigPath(paths.repoRoot) });
-    }
-    const results = candidates.map((c) => {
-        const cfg = readCodexAgenticrosConfig(c.path);
-        const validation = validateCodexAgenticrosConfig(cfg, mcpEntry);
-        return { ...c, cfg, validation };
-    });
-    if (opts.json) {
-        process.stdout.write(`${JSON.stringify({ results, mcpEntry }, null, 2)}\n`);
-        const anyRed = results.some((r) => r.validation.issues.some((i) => i.severity === "red"));
-        return anyRed ? 1 : 0;
+    if (!opts.json) {
+        header("Codex MCP doctor");
     }
-    header("Codex MCP doctor");
-    if (!mcpEntry) {
-        err("MCP server not built.");
-        return 1;
-    }
-    info(`Expected MCP entry: ${mcpEntry}\n`);
-    let exitCode = 0;
-    for (const r of results) {
-        process.stdout.write(`${colors.bold(r.label)} (${r.path})\n`);
-        if (!r.cfg.exists) {
-            process.stdout.write(`  ${colors.yellow("○")} Config file not present\n`);
-            process.stdout.write(`     ${colors.dim("→ Run `agenticros codex setup" + (r.label === "project" ? " --project" : "") + "`")}\n`);
-            if (r.label === "global")
-                exitCode = 1;
-            continue;
-        }
-        if (r.validation.ok) {
-            process.stdout.write(`  ${colors.green("✓")} agenticros MCP configured correctly\n`);
-            continue;
-        }
-        for (const issue of r.validation.issues) {
-            const icon = issue.severity === "red" ? colors.red("✗") : colors.yellow("○");
-            process.stdout.write(`  ${icon} ${issue.message}\n`);
-            if (issue.hint) {
-                process.stdout.write(`     ${colors.dim("→ " + issue.hint)}\n`);
-            }
-            if (issue.severity === "red")
-                exitCode = 1;
-        }
-    }
-    return exitCode;
-}
-function dimHint(message) {
-    process.stdout.write(`${colors.dim(message)}\n`);
+    return mcpDoctorCommand({ json: opts.json, hosts: ["codex"] });
 }
 //# sourceMappingURL=codex.js.map

package/dist/commands/codex.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/commands/codex.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/commands/codex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AActF,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA0B,EAAE;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IAErC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,eAAe,CAAC;YACpB,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,eAAe,CAAC;QACpB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA2B,EAAE;IACpE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BxE;AAED,sFAAsF;AACtF,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAGrD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAgZ7D"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyBH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BxE;AAED,sFAAsF;AACtF,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAGrD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CA0Z7D"}

package/dist/commands/doctor.js

@@ -16,8 +16,8 @@ import { colors, header, ok, warn, err, info } from "../util/logger.js";
 import { activeConfigPath, profilesDir, readActiveMode } from "../util/profiles.js";
 import { ensureToolsAlsoAllow, readAgenticrosContractTools, readOpenclawConfig, } from "../util/openclaw-config.js";
 import { listSkills } from "../util/skills.js";
-import { buildCodexDoctorChecks } from "../util/codex-config.js";
 import { findMcpEntry } from "../util/mcp-discovery.js";
+import { buildMcpDoctorChecks, claudeOnPath, codexOnPath, hermesOnPath, } from "../util/mcp-setup.js";
 export async function doctorCommand(opts) {
     const report = await runDoctorChecks();
     if (opts.json) {
@@ -206,28 +206,36 @@ export async function runDoctorChecks() {
                 : "Fine for real-robot mode if the value matches your robot's namespace.",
         });
     }
-    // Codex CLI MCP config.
+    // MCP client configs (Codex, Hermes, Claude).
     const mcpEntry = findMcpEntry();
-    checks.push(...buildCodexDoctorChecks(mcpEntry, paths.repoRoot));
-    try {
-        const { exitCode } = await execa("codex", ["--version"], { reject: false });
-        checks.push({
-            id: "codex-cli",
-            label: exitCode === 0 ? "Codex CLI installed" : "Codex CLI not detected",
-            severity: exitCode === 0 ? "green" : "yellow",
-            hint: exitCode === 0
-                ? undefined
-                : "Install from https://developers.openai.com/codex/ then run `agenticros codex setup`.",
-        });
-    }
-    catch {
-        checks.push({
-            id: "codex-cli",
-            label: "Codex CLI not detected",
-            severity: "yellow",
-            hint: "Install from https://developers.openai.com/codex/ then run `agenticros codex setup`.",
-        });
-    }
+    checks.push(...buildMcpDoctorChecks(mcpEntry, paths.repoRoot));
+    const hasCodex = await codexOnPath();
+    checks.push({
+        id: "codex-cli",
+        label: hasCodex ? "Codex CLI installed" : "Codex CLI not detected",
+        severity: hasCodex ? "green" : "yellow",
+        hint: hasCodex
+            ? undefined
+            : "Install from https://developers.openai.com/codex/ then run `agenticros mcp setup --codex`.",
+    });
+    const hasHermes = await hermesOnPath();
+    checks.push({
+        id: "hermes-cli",
+        label: hasHermes ? "Hermes CLI installed" : "Hermes CLI not detected",
+        severity: hasHermes ? "green" : "yellow",
+        hint: hasHermes
+            ? undefined
+            : "Install from https://github.com/NousResearch/hermes-agent then run `agenticros mcp setup --hermes`.",
+    });
+    const hasClaude = await claudeOnPath();
+    checks.push({
+        id: "claude-cli",
+        label: hasClaude ? "Claude Code CLI installed" : "Claude Code CLI not detected",
+        severity: hasClaude ? "green" : "yellow",
+        hint: hasClaude
+            ? undefined
+            : "Install from https://claude.com/product/claude-code then run `agenticros mcp setup --claude`.",
+    });
     // OpenAI key.
     const home = process.env["HOME"] ?? "";
     const authFile = join(home, ".openclaw", "agents", "main", "agent", "auth-profiles.json");