robot-resources 1.7.9 → 1.8.0

package/lib/detect.js

@@ -139,6 +139,22 @@ export function isHeadless() {
   return false;
 }
 
+/**
+ * Check if Claude Code is installed.
+ * Looks for ~/.claude/ directory which Claude Code creates on first run.
+ */
+export function isClaudeCodeInstalled() {
+  return existsSync(join(homedir(), '.claude'));
+}
+
+/**
+ * Check if Cursor is installed.
+ * Looks for ~/.cursor/ directory which Cursor creates on first run.
+ */
+export function isCursorInstalled() {
+  return existsSync(join(homedir(), '.cursor'));
+}
+
 /**
  * Check if the router service is already registered.
  */

package/lib/service.js

@@ -335,8 +335,16 @@ export function installService(venvPythonPath) {
       return {
         type: 'skipped',
         reason: 'Running inside Docker — service registration skipped.\n' +
-          '  Add this to your Dockerfile or entrypoint instead:\n' +
-          `  ${venvPythonPath} -m robot_resources.cli.main start`,
+          '  Options:\n' +
+          '  1. Dockerfile entrypoint:\n' +
+          `     CMD ["${venvPythonPath}", "-m", "robot_resources.cli.main", "start"]\n` +
+          '  2. Docker Compose sidecar:\n' +
+          '     services:\n' +
+          '       router:\n' +
+          `         command: ${venvPythonPath} -m robot_resources.cli.main start\n` +
+          '         ports: ["3838:3838"]\n' +
+          '  3. Background process:\n' +
+          `     ${venvPythonPath} -m robot_resources.cli.main start &`,
       };
     }
 

package/lib/tool-config.js

@@ -3,7 +3,7 @@ import { createRequire } from 'node:module';
 import { readFileSync, writeFileSync, copyFileSync, mkdirSync, existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
-import { isOpenClawInstalled, isOpenClawPluginInstalled, getOpenClawAuthMode } from './detect.js';
+import { isOpenClawInstalled, isOpenClawPluginInstalled, getOpenClawAuthMode, isClaudeCodeInstalled, isCursorInstalled } from './detect.js';
 import { stripJson5 } from './json5.js';
 
 /**
@@ -205,10 +205,123 @@ function configureOpenClaw() {
   }
 }
 
+/**
+ * Generate copy-pasteable SDK configuration instructions.
+ *
+ * Returned when no AI tools are auto-detected. Gives the developer
+ * exactly what they need to point their SDK at the router manually.
+ */
+function printManualInstructions() {
+  return {
+    name: 'Manual Configuration',
+    action: 'instructions',
+    instructions: [
+      'No AI tools detected for auto-configuration.',
+      'Point your SDK at the Router by setting the base URL:',
+      '',
+      '  # OpenAI SDK / compatible clients',
+      '  export OPENAI_BASE_URL=http://localhost:3838/v1',
+      '',
+      '  # Anthropic SDK',
+      '  export ANTHROPIC_BASE_URL=http://localhost:3838/v1',
+      '',
+      '  # Google Generative AI',
+      '  export GOOGLE_API_BASE=http://localhost:3838/v1',
+      '',
+      '  # Or pass base_url directly in your code:',
+      '  #   OpenAI(base_url="http://localhost:3838/v1")',
+      '  #   Anthropic(base_url="http://localhost:3838/v1")',
+      '',
+      'Docs: https://github.com/robot-resources/robot-resources',
+    ],
+  };
+}
+
+/**
+ * Configure Claude Code to use the Router as an MCP server.
+ *
+ * Writes a robot-resources-router entry to ~/.claude/settings.json
+ * under the mcpServers key. Claude Code reads this on startup.
+ */
+function configureClaudeCode() {
+  const configPath = join(homedir(), '.claude', 'settings.json');
+
+  try {
+    let config = {};
+    if (existsSync(configPath)) {
+      config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+
+    if (!config.mcpServers) config.mcpServers = {};
+
+    if (config.mcpServers['robot-resources-router']) {
+      return { name: 'Claude Code', action: 'already_configured' };
+    }
+
+    config.mcpServers['robot-resources-router'] = {
+      command: 'npx',
+      args: ['-y', '@robot-resources/router', 'mcp'],
+    };
+
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    return { name: 'Claude Code', action: 'configured' };
+  } catch {
+    return {
+      name: 'Claude Code',
+      action: 'instructions',
+      instructions: [
+        'Could not auto-configure Claude Code. Add manually to ~/.claude/settings.json:',
+        '  "mcpServers": { "robot-resources-router": { "command": "npx", "args": ["-y", "@robot-resources/router", "mcp"] } }',
+      ],
+    };
+  }
+}
+
+/**
+ * Configure Cursor to use the Router as an MCP server.
+ *
+ * Writes a robot-resources-router entry to ~/.cursor/mcp.json
+ * under the mcpServers key. Cursor reads this on startup.
+ */
+function configureCursor() {
+  const configPath = join(homedir(), '.cursor', 'mcp.json');
+
+  try {
+    let config = {};
+    if (existsSync(configPath)) {
+      config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+
+    if (!config.mcpServers) config.mcpServers = {};
+
+    if (config.mcpServers['robot-resources-router']) {
+      return { name: 'Cursor', action: 'already_configured' };
+    }
+
+    config.mcpServers['robot-resources-router'] = {
+      command: 'npx',
+      args: ['-y', '@robot-resources/router', 'mcp'],
+    };
+
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    return { name: 'Cursor', action: 'configured' };
+  } catch {
+    return {
+      name: 'Cursor',
+      action: 'instructions',
+      instructions: [
+        'Could not auto-configure Cursor. Add manually to ~/.cursor/mcp.json:',
+        '  "mcpServers": { "robot-resources-router": { "command": "npx", "args": ["-y", "@robot-resources/router", "mcp"] } }',
+      ],
+    };
+  }
+}
+
 /**
  * Configure all detected AI tools to route through the Router.
  *
  * Returns array of { name, action, ... } results.
+ * When no tools are detected, returns manual SDK instructions.
  */
 export function configureToolRouting() {
   const results = [];
@@ -218,6 +331,21 @@ export function configureToolRouting() {
     results.push(configureOpenClaw());
   }
 
+  // Claude Code
+  if (isClaudeCodeInstalled()) {
+    results.push(configureClaudeCode());
+  }
+
+  // Cursor
+  if (isCursorInstalled()) {
+    results.push(configureCursor());
+  }
+
+  // Fallback: manual SDK instructions when no tools detected
+  if (results.length === 0) {
+    results.push(printManualInstructions());
+  }
+
   return results;
 }
 
@@ -266,4 +394,4 @@ async function restartOpenClawGateway() {
 }
 
 // Exported for testing and direct use
-export { stripJson5, configureOpenClaw, registerScraperMcp, restartOpenClawGateway };
+export { stripJson5, configureOpenClaw, configureClaudeCode, configureCursor, registerScraperMcp, restartOpenClawGateway };

package/lib/wizard.js

@@ -372,7 +372,7 @@ export async function runWizard({ nonInteractive = false } = {}) {
 
   // ── Human notification (agent/non-interactive installs) ─────────────────
 
-  if (somethingInstalled && nonInteractive) {
+  if (somethingInstalled && nonInteractive && !process.env.RR_API_KEY) {
     blank();
     warn('IMPORTANT: Notify your human about this installation.');
     info('Robot Resources has made the following changes to this machine:');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robot-resources",
-  "version": "1.7.9",
+  "version": "1.8.0",
   "description": "Robot Resources — AI agent tools. One command to install everything.",
   "type": "module",
   "bin": {