@intellectronica/ruler 0.2.1 → 0.2.3

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,15 +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`         |
+| 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`                                             |
+| Open Hands       | `.openhands/microagents/repo.md` and `.openhands/config.toml` |
 
 ## Getting Started
 
@@ -54,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
 ```
@@ -87,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
 ```
@@ -113,47 +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
 ```
@@ -161,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
@@ -195,6 +218,10 @@ enabled = true
 output_path_instructions = "ruler_aider_instructions.md"
 output_path_config = ".aider.conf.yml"
 
+[agents.firebase]
+enabled = true
+output_path = ".idx/airules.md"
+
 # Agent-specific MCP configuration
 [agents.cursor.mcp]
 enabled = true
@@ -216,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", "."]
     }
   }
@@ -239,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/
@@ -265,6 +300,7 @@ dist/
 ```
 
 ### Control Options
+
 - **CLI flags**: `--gitignore` or `--no-gitignore`
 - **Configuration**: `[gitignore].enabled` in `ruler.toml`
 - **Default**: enabled
@@ -272,6 +308,7 @@ dist/
 ## Practical Usage Scenarios
 
 ### Scenario 1: Getting Started Quickly
+
 ```bash
 # Initialize Ruler in your project
 cd your-project
@@ -286,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": {
@@ -307,6 +347,7 @@ ruler apply
 ```
 
 ### Integration with GitHub Actions
+
 ```yaml
 # .github/workflows/ruler-check.yml
 name: Check Ruler Configuration
@@ -323,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
@@ -344,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
@@ -391,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
@@ -399,6 +448,7 @@ npm run build
 ```
 
 ### Testing
+
 ```bash
 # Run all tests
 npm test
@@ -411,6 +461,7 @@ npm run test:watch
 ```
 
 ### Code Quality
+
 ```bash
 # Run linting
 npm run lint
@@ -439,4 +490,4 @@ MIT
 ---
 
 © Eleanor Berger  
-[ai.intellectronica.net](https://ai.intellectronica.net/)
+[ai.intellectronica.net](https://ai.intellectronica.net/)

package/dist/agents/FirebaseAgent.js

@@ -0,0 +1,58 @@
+"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.FirebaseAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * Firebase Studio agent adapter.
+ */
+class FirebaseAgent {
+    getIdentifier() {
+        return 'firebase';
+    }
+    getName() {
+        return 'Firebase Studio';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, agentConfig) {
+        const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
+        await (0, FileSystemUtils_1.backupFile)(output);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
+    }
+    getDefaultOutputPath(projectRoot) {
+        return path.join(projectRoot, '.idx', 'airules.md');
+    }
+}
+exports.FirebaseAgent = FirebaseAgent;

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

@@ -58,7 +58,7 @@ function run() {
         });
         y.option('agents', {
             type: 'string',
-            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider',
+            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, firebase',
         });
         y.option('config', {
             type: 'string',
@@ -189,6 +189,10 @@ and apply them to your configured AI coding agents.
 # enabled = true
 # output_path_instructions = "ruler_aider_instructions.md"
 # output_path_config = ".aider.conf.yml"
+
+# [agents.firebase]
+# enabled = true
+# output_path = ".idx/airules.md"
 `;
         if (!(await exists(instructionsPath))) {
             await fs_1.promises.writeFile(instructionsPath, DEFAULT_INSTRUCTIONS);

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

@@ -47,9 +47,12 @@ const CursorAgent_1 = require("./agents/CursorAgent");
 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.
@@ -93,6 +96,8 @@ const agents = [
     new WindsurfAgent_1.WindsurfAgent(),
     new ClineAgent_1.ClineAgent(),
     new AiderAgent_1.AiderAgent(),
+    new FirebaseAgent_1.FirebaseAgent(),
+    new OpenHandsAgent_1.OpenHandsAgent(),
 ];
 /**
  * Applies ruler configurations for all supported AI agents.
@@ -190,27 +195,43 @@ 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';
+                    (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);
+                    }
+                    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);
+                    }
+                }
             }
         }
     }

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.1",
+  "version": "0.2.3",
   "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"
   }