@intellectronica/ruler 0.2.2 → 0.2.4

package/README.md

@@ -18,7 +18,7 @@
 Managing instructions across multiple AI coding tools becomes complex as your team grows. Different agents (GitHub Copilot, Claude, Cursor, Aider, etc.) require their own configuration files, leading to:
 
 - **Inconsistent guidance** across AI tools
-- **Duplicated effort** maintaining multiple config files  
+- **Duplicated effort** maintaining multiple config files
 - **Context drift** as project requirements evolve
 - **Onboarding friction** for new AI tools
 
@@ -35,16 +35,17 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 
 ## Supported AI Agents
 
-| Agent                  | File(s) Created/Updated                                    |
-| ---------------------- | ----------------------------------------------------------- |
-| GitHub Copilot         | `.github/copilot-instructions.md`                           |
-| Claude Code            | `CLAUDE.md`                                                 |
-| OpenAI Codex CLI       | `AGENTS.md`                                                 |
-| Cursor                 | `.cursor/rules/ruler_cursor_instructions.md`                |
-| Windsurf               | `.windsurf/rules/ruler_windsurf_instructions.md`            |
-| Cline                  | `.clinerules`                                               |
-| Aider                  | `ruler_aider_instructions.md` and `.aider.conf.yml`         |
-| Firebase Studio        | `.idx/airules.md`                                           |
+| Agent            | File(s) Created/Updated                                       |
+| ---------------- | ------------------------------------------------------------- |
+| GitHub Copilot   | `.github/copilot-instructions.md`                             |
+| Claude Code      | `CLAUDE.md`                                                   |
+| OpenAI Codex CLI | `AGENTS.md`                                                   |
+| Cursor           | `.cursor/rules/ruler_cursor_instructions.mdc`                 |
+| Windsurf         | `.windsurf/rules/ruler_windsurf_instructions.md`              |
+| Cline            | `.clinerules`                                                 |
+| Aider            | `ruler_aider_instructions.md` and `.aider.conf.yml`           |
+| Firebase Studio  | `.idx/airules.md`                                             |
+| Open Hands       | `.openhands/microagents/repo.md` and `.openhands/config.toml` |
 
 ## Getting Started
 
@@ -55,11 +56,13 @@ Node.js 18.x or higher is required.
 ### Installation
 
 **Global Installation (Recommended for CLI use):**
+
 ```bash
 npm install -g @intellectronica/ruler
 ```
 
 **Using `npx` (for one-off commands):**
+
 ```bash
 npx @intellectronica/ruler apply
 ```
@@ -88,25 +91,30 @@ This is your central hub for all AI agent instructions:
 ### Best Practices for Rule Files
 
 **Granularity**: Break down complex instructions into focused `.md` files:
+
 - `coding_style.md`
-- `api_conventions.md`  
+- `api_conventions.md`
 - `project_architecture.md`
 - `security_guidelines.md`
 
 **Example rule file (`.ruler/python_guidelines.md`):**
+
 ```markdown
 # Python Project Guidelines
 
 ## General Style
+
 - Follow PEP 8 for all Python code
 - Use type hints for all function signatures and complex variables
 - Keep functions short and focused on a single task
 
 ## Error Handling
+
 - Use specific exception types rather than generic `Exception`
 - Log errors effectively with context
 
 ## Security
+
 - Always validate and sanitize user input
 - Be mindful of potential injection vulnerabilities
 ```
@@ -114,52 +122,59 @@ This is your central hub for all AI agent instructions:
 ## Usage: The `apply` Command
 
 ### Primary Command
+
 ```bash
 ruler apply [options]
 ```
 
 ### Options
 
-| Option | Description |
-|--------|-------------|
-| `--project-root <path>` | Path to your project's root (default: current directory) |
-| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to target |
-| `--config <path>` | Path to a custom `ruler.toml` configuration file |
-| `--mcp` / `--with-mcp` | Enable applying MCP server configurations (default: true) |
-| `--no-mcp` | Disable applying MCP server configurations |
-| `--mcp-overwrite` | Overwrite native MCP config entirely instead of merging |
-| `--gitignore` | Enable automatic .gitignore updates (default: true) |
-| `--no-gitignore` | Disable automatic .gitignore updates |
-| `--verbose` / `-v` | Display detailed output during execution |
+| Option                         | Description                                               |
+| ------------------------------ | --------------------------------------------------------- |
+| `--project-root <path>`        | Path to your project's root (default: current directory)  |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to target             |
+| `--config <path>`              | Path to a custom `ruler.toml` configuration file          |
+| `--mcp` / `--with-mcp`         | Enable applying MCP server configurations (default: true) |
+| `--no-mcp`                     | Disable applying MCP server configurations                |
+| `--mcp-overwrite`              | Overwrite native MCP config entirely instead of merging   |
+| `--gitignore`                  | Enable automatic .gitignore updates (default: true)       |
+| `--no-gitignore`               | Disable automatic .gitignore updates                      |
+| `--verbose` / `-v`             | Display detailed output during execution                  |
 
 ### Common Examples
 
 **Apply rules to all configured agents:**
+
 ```bash
 ruler apply
 ```
 
 **Apply rules only to GitHub Copilot and Claude:**
+
 ```bash
 ruler apply --agents copilot,claude
 ```
 
 **Apply rules only to Firebase Studio:**
+
 ```bash
 ruler apply --agents firebase
 ```
 
 **Use a specific configuration file:**
+
 ```bash
 ruler apply --config ./team-configs/ruler.frontend.toml
 ```
 
 **Apply rules with verbose output:**
+
 ```bash
 ruler apply --verbose
 ```
 
 **Apply rules but skip MCP and .gitignore updates:**
+
 ```bash
 ruler apply --no-mcp --no-gitignore
 ```
@@ -167,9 +182,11 @@ ruler apply --no-mcp --no-gitignore
 ## Configuration (`ruler.toml`) in Detail
 
 ### Location
+
 Defaults to `.ruler/ruler.toml` in the project root. Override with `--config` CLI option.
 
 ### Complete Example
+
 ```toml
 # Default agents to run when --agents is not specified
 # Uses case-insensitive substring matching
@@ -226,16 +243,22 @@ enabled = false
 MCP provides broader context to AI models through server configurations. Ruler can manage and distribute these settings across compatible agents.
 
 ### `.ruler/mcp.json`
+
 Define your project's MCP servers:
+
 ```json
 {
   "mcpServers": {
     "filesystem": {
       "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-filesystem",
+        "/path/to/project"
+      ]
     },
     "git": {
-      "command": "npx", 
+      "command": "npx",
       "args": ["-y", "@modelcontextprotocol/server-git", "--repository", "."]
     }
   }
@@ -249,12 +272,14 @@ Ruler uses this file with the `merge` (default) or `overwrite` strategy, control
 Ruler automatically manages your `.gitignore` file to keep generated agent configuration files out of version control.
 
 ### How it Works
+
 - Creates or updates `.gitignore` in your project root
 - Adds paths to a managed block marked with `# START Ruler Generated Files` and `# END Ruler Generated Files`
 - Preserves existing content outside this block
 - Sorts paths alphabetically and uses relative POSIX-style paths
 
 ### Example `.gitignore` Section
+
 ```gitignore
 # Your existing rules
 node_modules/
@@ -263,7 +288,7 @@ node_modules/
 # START Ruler Generated Files
 .aider.conf.yml
 .clinerules
-.cursor/rules/ruler_cursor_instructions.md
+.cursor/rules/ruler_cursor_instructions.mdc
 .github/copilot-instructions.md
 .windsurf/rules/ruler_windsurf_instructions.md
 AGENTS.md
@@ -275,6 +300,7 @@ dist/
 ```
 
 ### Control Options
+
 - **CLI flags**: `--gitignore` or `--no-gitignore`
 - **Configuration**: `[gitignore].enabled` in `ruler.toml`
 - **Default**: enabled
@@ -282,6 +308,7 @@ dist/
 ## Practical Usage Scenarios
 
 ### Scenario 1: Getting Started Quickly
+
 ```bash
 # Initialize Ruler in your project
 cd your-project
@@ -296,16 +323,19 @@ ruler apply
 ```
 
 ### Scenario 2: Team Standardization
+
 1. Create `.ruler/coding_standards.md`, `.ruler/api_usage.md`
 2. Commit the `.ruler` directory to your repository
 3. Team members pull changes and run `ruler apply` to update their local AI agent configurations
 
 ### Scenario 3: Project-Specific Context for AI
+
 1. Detail your project's architecture in `.ruler/project_overview.md`
-2. Describe primary data structures in `.ruler/data_models.md`  
+2. Describe primary data structures in `.ruler/data_models.md`
 3. Run `ruler apply` to help AI tools provide more relevant suggestions
 
 ### Integration with NPM Scripts
+
 ```json
 {
   "scripts": {
@@ -317,6 +347,7 @@ ruler apply
 ```
 
 ### Integration with GitHub Actions
+
 ```yaml
 # .github/workflows/ruler-check.yml
 name: Check Ruler Configuration
@@ -333,13 +364,13 @@ jobs:
         with:
           node-version: '18'
           cache: 'npm'
-      
+
       - name: Install Ruler
         run: npm install -g @intellectronica/ruler
-      
+
       - name: Apply Ruler configuration
         run: ruler apply --no-gitignore
-      
+
       - name: Check for uncommitted changes
         run: |
           if [[ -n $(git status --porcelain) ]]; then
@@ -354,28 +385,35 @@ jobs:
 ### Common Issues
 
 **"Cannot find module" errors:**
+
 - Ensure Ruler is installed globally: `npm install -g @intellectronica/ruler`
 - Or use `npx @intellectronica/ruler`
 
 **Permission denied errors:**
+
 - On Unix systems, you may need `sudo` for global installation
 
 **Agent files not updating:**
+
 - Check if the agent is enabled in `ruler.toml`
 - Verify agent isn't excluded by `--agents` flag
 - Use `--verbose` to see detailed execution logs
 
 **Configuration validation errors:**
+
 - Ruler now validates `ruler.toml` format and will show specific error details
 - Check that all configuration values match the expected types and formats
 
 ### Debug Mode
+
 Use `--verbose` flag to see detailed execution logs:
+
 ```bash
 ruler apply --verbose
 ```
 
 This shows:
+
 - Configuration loading details
 - Agent selection logic
 - File processing information
@@ -401,6 +439,7 @@ A: Version 0.2.0 is backward compatible. Your existing `.ruler/` directory and `
 ## Development
 
 ### Setup
+
 ```bash
 git clone https://github.com/intellectronica/ruler.git
 cd ruler
@@ -409,6 +448,7 @@ npm run build
 ```
 
 ### Testing
+
 ```bash
 # Run all tests
 npm test
@@ -421,6 +461,7 @@ npm run test:watch
 ```
 
 ### Code Quality
+
 ```bash
 # Run linting
 npm run lint
@@ -449,4 +490,4 @@ MIT
 ---
 
 © Eleanor Berger  
-[ai.intellectronica.net](https://ai.intellectronica.net/)
+[ai.intellectronica.net](https://ai.intellectronica.net/)

package/dist/agents/CopilotAgent.js

@@ -55,5 +55,8 @@ class CopilotAgent {
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, '.github', 'copilot-instructions.md');
     }
+    getMcpServerKey() {
+        return 'servers';
+    }
 }
 exports.CopilotAgent = CopilotAgent;

package/dist/agents/CursorAgent.js

@@ -53,7 +53,7 @@ class CursorAgent {
         await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
     }
     getDefaultOutputPath(projectRoot) {
-        return path.join(projectRoot, '.cursor', 'rules', 'ruler_cursor_instructions.md');
+        return path.join(projectRoot, '.cursor', 'rules', 'ruler_cursor_instructions.mdc');
     }
 }
 exports.CursorAgent = CursorAgent;

package/dist/agents/OpenHandsAgent.js

@@ -0,0 +1,56 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenHandsAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+class OpenHandsAgent {
+    getIdentifier() {
+        return 'openhands';
+    }
+    getName() {
+        return 'Open Hands';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, agentConfig) {
+        const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
+        await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(output));
+        await (0, FileSystemUtils_1.backupFile)(output);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
+    }
+    getDefaultOutputPath(projectRoot) {
+        return path.join(projectRoot, '.openhands', 'microagents', 'repo.md');
+    }
+}
+exports.OpenHandsAgent = OpenHandsAgent;

package/dist/cli/commands.js

@@ -175,7 +175,7 @@ and apply them to your configured AI coding agents.
 
 # [agents.cursor]
 # enabled = true
-# output_path = ".cursor/rules/ruler_cursor_instructions.md"
+# output_path = ".cursor/rules/ruler_cursor_instructions.mdc"
 
 # [agents.windsurf]
 # enabled = true

package/dist/core/ConfigLoader.js

@@ -39,7 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadConfig = loadConfig;
 const fs_1 = require("fs");
 const path = __importStar(require("path"));
-const toml_1 = __importDefault(require("toml"));
+const toml_1 = __importDefault(require("@iarna/toml"));
 const zod_1 = require("zod");
 const constants_1 = require("../constants");
 const mcpConfigSchema = zod_1.z

package/dist/lib.js

@@ -48,9 +48,11 @@ const WindsurfAgent_1 = require("./agents/WindsurfAgent");
 const ClineAgent_1 = require("./agents/ClineAgent");
 const AiderAgent_1 = require("./agents/AiderAgent");
 const FirebaseAgent_1 = require("./agents/FirebaseAgent");
+const OpenHandsAgent_1 = require("./agents/OpenHandsAgent");
 const merge_1 = require("./mcp/merge");
 const validate_1 = require("./mcp/validate");
 const mcp_1 = require("./paths/mcp");
+const propagateOpenHandsMcp_1 = require("./mcp/propagateOpenHandsMcp");
 const constants_1 = require("./constants");
 /**
  * Gets all output paths for an agent, taking into account any config overrides.
@@ -95,6 +97,7 @@ const agents = [
     new ClineAgent_1.ClineAgent(),
     new AiderAgent_1.AiderAgent(),
     new FirebaseAgent_1.FirebaseAgent(),
+    new OpenHandsAgent_1.OpenHandsAgent(),
 ];
 /**
  * Applies ruler configurations for all supported AI agents.
@@ -192,27 +195,45 @@ async function applyAllAgentConfigs(projectRoot, includedAgents, configPath, cli
         (0, constants_1.logVerbose)(`Agent ${agent.getName()} output paths: ${outputPaths.join(', ')}`, verbose);
         generatedPaths.push(...outputPaths);
         if (dryRun) {
-            (0, constants_1.logVerbose)(`DRY RUN: Would write rules to: ${outputPaths.join(', ')}`, true);
+            (0, constants_1.logVerbose)(`DRY RUN: Would write rules to: ${outputPaths.join(', ')}`, verbose);
         }
         else {
             await agent.applyRulerConfig(concatenated, projectRoot, agentConfig);
         }
         const dest = await (0, mcp_1.getNativeMcpPath)(agent.getName(), projectRoot);
-        const enabled = cliMcpEnabled &&
+        const mcpEnabledForAgent = cliMcpEnabled &&
             (agentConfig?.mcp?.enabled ?? config.mcp?.enabled ?? true);
-        if (dest && rulerMcpJson != null && enabled) {
-            const strategy = cliMcpStrategy ??
-                agentConfig?.mcp?.strategy ??
-                config.mcp?.strategy ??
-                'merge';
-            (0, constants_1.logVerbose)(`Applying MCP config for ${agent.getName()} with strategy: ${strategy}`, verbose);
-            if (dryRun) {
-                (0, constants_1.logVerbose)(`DRY RUN: Would apply MCP config to: ${dest}`, true);
+        const rulerMcpFile = path.join(rulerDir, 'mcp.json');
+        if (dest && mcpEnabledForAgent) {
+            if (agent.getIdentifier() === 'openhands') {
+                // *** Special handling for Open Hands ***
+                if (dryRun) {
+                    (0, constants_1.logVerbose)(`DRY RUN: Would apply MCP config by updating TOML file: ${dest}`, verbose);
+                }
+                else {
+                    await (0, propagateOpenHandsMcp_1.propagateMcpToOpenHands)(rulerMcpFile, dest);
+                }
+                // Include Open Hands config file in .gitignore
+                generatedPaths.push(dest);
             }
             else {
-                const existing = await (0, mcp_1.readNativeMcp)(dest);
-                const merged = (0, merge_1.mergeMcp)(existing, rulerMcpJson, strategy);
-                await (0, mcp_1.writeNativeMcp)(dest, merged);
+                if (rulerMcpJson) {
+                    const strategy = cliMcpStrategy ??
+                        agentConfig?.mcp?.strategy ??
+                        config.mcp?.strategy ??
+                        'merge';
+                    // Determine the correct server key for the agent
+                    const serverKey = agent.getMcpServerKey?.() ?? 'mcpServers';
+                    (0, constants_1.logVerbose)(`Applying MCP config for ${agent.getName()} with strategy: ${strategy} and key: ${serverKey}`, verbose);
+                    if (dryRun) {
+                        (0, constants_1.logVerbose)(`DRY RUN: Would apply MCP config to: ${dest}`, true);
+                    }
+                    else {
+                        const existing = await (0, mcp_1.readNativeMcp)(dest);
+                        const merged = (0, merge_1.mergeMcp)(existing, rulerMcpJson, strategy, serverKey);
+                        await (0, mcp_1.writeNativeMcp)(dest, merged);
+                    }
+                }
             }
         }
     }

package/dist/mcp/merge.js

@@ -6,16 +6,26 @@ exports.mergeMcp = mergeMcp;
  * @param base Existing native MCP config object.
  * @param incoming Ruler MCP config object.
  * @param strategy Merge strategy: 'merge' to union servers, 'overwrite' to replace.
+ * @param serverKey The key to use for servers in the output (e.g., 'servers' for Copilot, 'mcpServers' for others).
  * @returns Merged MCP config object.
  */
-function mergeMcp(base, incoming, strategy) {
+function mergeMcp(base, incoming, strategy, serverKey) {
     if (strategy === 'overwrite') {
-        return incoming;
+        // Ensure the incoming object uses the correct server key.
+        const incomingServers = incoming.mcpServers || {};
+        return {
+            [serverKey]: incomingServers,
+        };
     }
-    const baseServers = base.mcpServers || {};
+    const baseServers = base[serverKey] ||
+        base.mcpServers ||
+        {}; // Handle legacy key in existing files
     const incomingServers = incoming.mcpServers || {};
+    const mergedServers = { ...baseServers, ...incomingServers };
+    const newBase = { ...base };
+    delete newBase.mcpServers; // Remove old key if present
     return {
-        ...base,
-        mcpServers: { ...baseServers, ...incomingServers },
+        ...newBase,
+        [serverKey]: mergedServers,
     };
 }

package/dist/mcp/propagateOpenHandsMcp.js

@@ -0,0 +1,83 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.propagateMcpToOpenHands = propagateMcpToOpenHands;
+const fs = __importStar(require("fs/promises"));
+const toml_1 = __importDefault(require("@iarna/toml"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const path = __importStar(require("path"));
+async function propagateMcpToOpenHands(rulerMcpPath, openHandsConfigPath) {
+    let rulerMcp;
+    try {
+        const rulerJsonContent = await fs.readFile(rulerMcpPath, 'utf8');
+        rulerMcp = JSON.parse(rulerJsonContent);
+    }
+    catch {
+        return;
+    }
+    const rulerServers = rulerMcp.mcpServers || {};
+    let config = {};
+    try {
+        const tomlContent = await fs.readFile(openHandsConfigPath, 'utf8');
+        config = toml_1.default.parse(tomlContent);
+    }
+    catch {
+        // File doesn't exist, we'll create it.
+    }
+    if (!config.mcp) {
+        config.mcp = {};
+    }
+    if (!config.mcp.stdio_servers) {
+        config.mcp.stdio_servers = [];
+    }
+    const existingServers = new Map(config.mcp.stdio_servers.map((s) => [s.name, s]));
+    for (const [name, serverDef] of Object.entries(rulerServers)) {
+        const { command, args, env } = serverDef;
+        if (command) {
+            const newServer = { name, command };
+            if (args)
+                newServer.args = args;
+            if (env)
+                newServer.env = env;
+            existingServers.set(name, newServer);
+        }
+    }
+    config.mcp.stdio_servers = Array.from(existingServers.values());
+    await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(openHandsConfigPath));
+    await fs.writeFile(openHandsConfigPath, toml_1.default.stringify(config));
+}

package/dist/paths/mcp.js

@@ -67,6 +67,10 @@ async function getNativeMcpPath(adapterName, projectRoot) {
         case 'Aider':
             candidates.push(path.join(projectRoot, '.mcp.json'));
             break;
+        case 'Open Hands':
+            // For Open Hands, we target the main config file, not a separate mcp.json
+            candidates.push(path.join(projectRoot, '.openhands', 'config.toml'));
+            break;
         default:
             return null;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectronica/ruler",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {
@@ -43,6 +43,7 @@
     "ruler": "dist/cli/index.js"
   },
   "devDependencies": {
+    "@types/iarna__toml": "^2.0.5",
     "@types/jest": "^29.5.14",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.15.24",
@@ -58,8 +59,8 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
+    "@iarna/toml": "^2.2.5",
     "js-yaml": "^4.1.0",
-    "toml": "^3.0.0",
     "yargs": "^17.7.2",
     "zod": "^3.25.28"
   }