@eventmodelers/cli 1.0.100 → 1.0.102

package/README.md

@@ -217,8 +217,8 @@ server to register by hand (`<baseUrl>/mcp`, header `x-token` from `$EVENTMODELE
 Run `init-agents --hosts <harness>` to install the skills for a harness that does not read
 `.claude/skills`. There are no subagents: self-directed work is done inline.
 
-**In a container.** `docker/agent/Dockerfile` runs the modeling agent with Claude Code, OpenCode and Codex all installed;
-`AGENT` (`claude` by default, `opencode` or `codex`) picks which one runs. Build from this directory and pass the board's
+**In a container.** `docker/agent/Dockerfile` runs the modeling agent with Claude Code, OpenCode, Codex, Gemini CLI and Hermes all installed;
+`AGENT` (`claude` by default, or `opencode`, `codex`, `gemini`, `hermes`) picks which one runs. Build from this directory and pass the board's
 credentials as env vars:
 
 ```bash
@@ -232,6 +232,15 @@ Claude authenticates with `ANTHROPIC_API_KEY`, or with your subscription via `CL
 once). The container is the sandbox, so the image sets `EVENTMODELERS_CODEX_NO_SANDBOX=1`, which makes the `codex` preset run
 `--dangerously-bypass-approvals-and-sandbox` instead of `--full-auto`.
 
+Keys: `OPENAI_API_KEY` (codex), `GEMINI_API_KEY` (gemini), and for Hermes a provider key such as `OPENROUTER_API_KEY`. Hermes reads MCP
+servers only from `~/.hermes/config.yaml`, so the images ship the eventmodelers server there (env references, no secret); outside
+Docker the CLI logs the snippet to add. Run `hermes` in a container as `-e AGENT=hermes --model <provider/model>`.
+
+**Any OpenAI-compatible endpoint with OpenCode.** `-e MODEL_BASE_URL=<url> -e MODEL_NAME=<id> [-e MODEL_API_KEY=...]` makes the
+OpenCode container (`AGENT=opencode`, agent and build images) use that endpoint — a local Ollama/vLLM (`http://host.docker.internal:11434/v1`),
+OpenRouter, LiteLLM or a company gateway — without writing an `opencode.json`. The entrypoint registers it as provider `custom` and runs
+`--model custom/<MODEL_NAME>`. `MODEL_NAME` is required; other agents reject `MODEL_BASE_URL`.
+
 `--agent`, `--exec`, `--local-ai` and `--bash` each pick the runner, so pass at most one of them —
 any two together are rejected. For a local or self-hosted model use `--local-ai`, not `--agent`.
 

package/cli.js

@@ -82,6 +82,9 @@ const AGENT_PRESETS = {
   opencode: { modeling: 'opencode run --standalone --auto', build: 'opencode run --standalone --auto --format json' },
   codex: { modeling: 'codex exec --full-auto', build: 'codex exec --json --full-auto' },
   gemini: { modeling: 'gemini --yolo -p', build: 'gemini --yolo --output-format stream-json -p' },
+  // -q takes the prompt, so the preset ends with it (the --model flag is inserted before it, below).
+  // -Q is the plain-text mode a modeling turn reads its answer from; --format stream-json is the build kit's.
+  hermes: { modeling: 'hermes chat --yolo -Q -q', build: 'hermes chat --yolo --format stream-json -q' },
 };
 
 function printAgentPresets() {
@@ -3630,7 +3633,11 @@ credentialFlags(program
       console.error('❌ --model does not apply to --exec — put the harness\'s own model flag in the command (e.g. --exec "opencode run --standalone -m <id>"), or use --agent.');
       process.exit(1);
     }
-    if (model && agentExec) opts.exec = `${agentExec} -m '${model.replace(/'/g, `'\\''`)}'`;
+    if (model && agentExec) {
+      const modelFlag = `-m '${model.replace(/'/g, `'\\''`)}'`;
+      // A trailing -q takes the prompt as its value, so the model flag has to come before it.
+      opts.exec = agentExec.endsWith(' -q') ? `${agentExec.slice(0, -3)}${modelFlag} -q` : `${agentExec} ${modelFlag}`;
+    }
     else if (model && resolveLocalAiTarget(opts) !== null) process.env.LOCAL_AI_MODEL = model;
     // The default Claude runner: the build kit's ralph-claude.js reads RALPH_MODEL from the env it
     // inherits; the modeling loop takes it as runModeling's `model`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventmodelers/cli",
-  "version": "1.0.100",
+  "version": "1.0.102",
   "description": "Eventmodelers CLI — real-time Claude agent + skills for Claude Code, for any stack (Node, Supabase, Axon, OpenCQRS, UmaDB, Kurrent, or modeling-only)",
   "type": "module",
   "bin": {

package/shared/build-kit/lib/mcp-register.js

@@ -1,8 +1,9 @@
-// Registers the eventmodelers MCP server with an external agent harness (OpenCode, Gemini, Codex),
+// Registers the eventmodelers MCP server with an external agent harness (OpenCode, Gemini, Codex, Hermes),
 // for both loops that hand turns to one: the modeling loop (lib/modeling-exec.js) and the build
 // loop (ralph-exec.js).
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
 import { dirname, join } from 'path';
 
 // POSIX single-quote escaping: close, insert an escaped quote, reopen. A turn is multi-line
@@ -60,6 +61,18 @@ const MCP_REGISTRATIONS = {
     });
     return { command, file: ok ? '.gemini/settings.json' : null, manual: ok ? null : `add mcpServers.eventmodelers = ${JSON.stringify(entry)} to .gemini/settings.json` };
   },
+  // Hermes reads MCP servers from ~/.hermes/config.yaml only (there is no project-level file), so
+  // this never writes it — a user-wide file is not ours to rewrite. It reports the server as
+  // registered when the file already names it (the docker images ship it), and says what to add otherwise.
+  hermes: (command, _projectDir, url) => {
+    const file = join(process.env.HERMES_HOME || join(homedir(), '.hermes'), 'config.yaml');
+    const has = existsSync(file) && /^\s+eventmodelers:/m.test(readFileSync(file, 'utf8'));
+    return {
+      command,
+      file: null,
+      manual: has ? null : `add to ${file}:\nmcp_servers:\n  eventmodelers:\n    url: "${url}"\n    headers:\n      x-token: "\${EVENTMODELERS_TOKEN}"`,
+    };
+  },
   codex: (command, _projectDir, url) => ({
     // -c values are TOML; env_http_headers names the env var each header is read from.
     command: `${command} -c ${shellQuote(`mcp_servers.eventmodelers.url="${url}"`)} -c ${shellQuote('mcp_servers.eventmodelers.env_http_headers={x-token="EVENTMODELERS_TOKEN",x-agent-id="EVENTMODELERS_AGENT_ID"}')}`,
@@ -89,7 +102,7 @@ export function registerMcp(command, projectDir, baseUrl, log) {
     return { command, registered: false };
   }
   const reg = MCP_REGISTRATIONS[harness](command, projectDir, url);
-  if (reg.manual) log(`MCP: could not update the ${harness} config (not plain JSON) — ${reg.manual}`);
+  if (reg.manual) log(`MCP: could not update the ${harness} config${harness === 'hermes' ? '' : ' (not plain JSON)'} — ${reg.manual}`);
   else log(`MCP: eventmodelers registered for ${harness}${reg.file ? ` in ${reg.file}` : ' via -c flags'}`);
   return { command: reg.command, registered: !reg.manual };
 }