@eventmodelers/cli 1.0.13 → 1.0.14

package/README.md

@@ -105,6 +105,7 @@ npx @eventmodelers/cli re-init                      # refresh an already-install
 npx @eventmodelers/cli run                          # start the agent loop (ralph-claude.js) from the installed kit dir
 npx @eventmodelers/cli run --ollama                 # same, via local Ollama (ralph-ollama.js)
 npx @eventmodelers/cli run --bash                   # bash-only loop, no realtime (ralph.sh)
+npx @eventmodelers/cli run --local                  # skip platform config/credential lookup entirely — local-only, no board sync
 npx @eventmodelers/cli fetch --context <name>                     # pull full slice detail for one context on the board into <kit-dir>/.slices/
 npx @eventmodelers/cli fetch --context <name> --slice-id <id>     # same, then print just that slice
 npx @eventmodelers/cli fetch --context <name> --slice-title <title> # same, then print just the slice matching this title

package/cli.js

@@ -1772,6 +1772,7 @@ program
   .option('--ollama', 'Use ralph-ollama.js instead of the default Claude runner (build-kit stacks only)')
   .option('--bash', 'Use the bash-only ralph.sh loop (build-kit stacks only, no realtime)')
   .option('--modeling', 'Keep one Claude process warm across prompts instead of spawning a fresh one per task, for low-latency voice/live use. Modeling-kit installs only — there is no cold-spawn/tasks.json loop for modeling-kit. Built into the CLI, not a per-project file.')
+  .option('--local', 'Skip platform config/credential lookup entirely and run the local-only loop (no board sync, no realtime agent) — even if .eventmodelers/config.json has credentials (build-kit stacks only)')
   .option('--verbose', 'Log every tool call\'s full input (commands, skill args, file paths) and assistant reasoning text. Default is condensed, high-level per-step logging only.')
   .action(async (opts) => {
     const cwd = process.cwd();
@@ -1799,6 +1800,10 @@ program
         console.error('❌ --modeling is mutually exclusive with --bash/--ollama — those select a build-kit runner, which --modeling has no use for.');
         process.exit(1);
       }
+      if (opts.local) {
+        console.error('❌ --modeling has no local-only mode — it is always driven by the org-wide realtime prompt queue, so --local has no use for it.');
+        process.exit(1);
+      }
       if (!modelingKitDir) {
         console.error(`❌ --modeling only supports a modeling-kit install (${MODELING_KIT.kitDirName}/) — it subscribes to the org-wide prompt queue, which build-kit stacks don't have. Use \`eventmodelers run\` (optionally with --ollama/--bash) for build-kit's slice-status loop instead.`);
         process.exit(1);
@@ -1850,9 +1855,11 @@ program
     console.log(`▶ Starting ${relative(cwd, runnerPath)}...\n`);
     const cmd = runner.endsWith('.sh') ? `"${runnerPath}"` : `node "${runnerPath}"`;
     try {
-      // Only ralph-claude.js reads this — the bash loop and the ollama executor have
-      // their own separate output paths with no stream-json parsing to gate.
-      execSync(cmd, { cwd: kitDir, stdio: 'inherit', env: { ...process.env, RALPH_VERBOSE: opts.verbose ? '1' : '' } });
+      // Only ralph-claude.js reads RALPH_VERBOSE — the bash loop and the ollama executor have
+      // their own separate output paths with no stream-json parsing to gate. RALPH_LOCAL is
+      // read by all three runners (ralph.js's startRalph, and ralph.sh directly) to force the
+      // local-only branch even when .eventmodelers/config.json has valid credentials.
+      execSync(cmd, { cwd: kitDir, stdio: 'inherit', env: { ...process.env, RALPH_VERBOSE: opts.verbose ? '1' : '', RALPH_LOCAL: opts.local ? '1' : '' } });
     } catch (err) {
       process.exit(err.status || 1);
     }

package/package.json

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

package/shared/build-kit/lib/ralph.js

@@ -397,15 +397,19 @@ async function ralphLoop(kitDir, cfg, onTask, onPlannedSlice) {
 
 export { loadLocalConfig, fetchPlatformConfig, retryOn401, startRealtimeAgent };
 
-export async function startRalph({ kitDir, projectDir, onTask, onPlannedSlice, agentType = 'BUILD', queueAllStatuses = false }) {
+export async function startRalph({ kitDir, projectDir, onTask, onPlannedSlice, agentType = 'BUILD', queueAllStatuses = false, localOnly = false }) {
   const local = loadLocalConfig(kitDir);
   local.agentId = ensureAgentId(kitDir, agentType);
 
   console.log(`Ralph — kit: ${kitDir}`);
   console.log(`         project: ${projectDir}`);
 
-  if (!hasCredentials(local)) {
-    console.log(`         mode: local-only (no platform sync)\n`);
+  // localOnly (set via `eventmodelers run --local`) forces this branch even when
+  // credentials are present — it skips fetchPlatformConfig's network call to
+  // ${baseUrl}/api/config and startRealtimeAgent entirely, so the loop never
+  // reaches out to the platform at all.
+  if (localOnly || !hasCredentials(local)) {
+    console.log(`         mode: local-only (no platform sync)${localOnly ? ' — forced by --local' : ''}\n`);
     await ralphLoop(kitDir, local, onTask, onPlannedSlice);
     return;
   }

package/shared/build-kit/ralph-claude.js

@@ -96,6 +96,7 @@ startRalph({
   projectDir,
   onTask: runClaude,
   onPlannedSlice: runClaude,
+  localOnly: process.env.RALPH_LOCAL === '1',
 }).catch((err) => {
   console.error('[ralph] Fatal:', err);
   process.exit(1);

package/shared/build-kit/ralph-ollama.js

@@ -33,6 +33,7 @@ startRalph({
   projectDir,
   onTask: runOllama,
   // onPlannedSlice omitted — ollama-agent manages its own task queue
+  localOnly: process.env.RALPH_LOCAL === '1',
 }).catch((err) => {
   console.error('[ralph] Fatal:', err);
   process.exit(1);

package/shared/build-kit/ralph.sh

@@ -21,7 +21,10 @@ BACKEND_PROMPT_FILE="$KIT_DIR/lib/backend-prompt.md"
 AGENT_SCRIPT="$KIT_DIR/lib/agent.sh"
 
 HAS_CREDENTIALS=true
-if [[ ! -f "$KIT_DIR/.eventmodelers/config.json" ]]; then
+if [[ "${RALPH_LOCAL:-}" == "1" ]]; then
+  echo "[ralph] --local — platform sync disabled." >&2
+  HAS_CREDENTIALS=false
+elif [[ ! -f "$KIT_DIR/.eventmodelers/config.json" ]]; then
   echo "[ralph] Note: no .eventmodelers/config.json found — platform sync disabled." >&2
   echo "        To enable board sync, follow: https://app.eventmodelers.ai/documentation#build" >&2
   echo "        Code generation from local slice definitions will still run." >&2