@intellectronica/ruler 0.2.10 → 0.2.12

package/README.md

@@ -50,6 +50,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Gemini CLI       | `GEMINI.md`                                      | `.gemini/settings.json`                          |
 | Junie            | `.junie/guidelines.md`                           | -                                                |
 | AugmentCode      | `.augment/rules/ruler_augment_instructions.md`   | `.vscode/settings.json`                          |
+| Kilo Code        | `.kilocode/rules/ruler_kilocode_instructions.md` | `.kilocode/mcp.json`                             |
 
 ## Getting Started
 
@@ -145,7 +146,7 @@ The `apply` command looks for `.ruler/` in the current directory tree, reading t
 | 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 (copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, augmentcode) |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to target (copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, augmentcode, kilocode) |
 | `--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                |
@@ -216,7 +217,7 @@ ruler revert [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 revert (copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie) |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to revert (copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, kilocode) |
 | `--config <path>`              | Path to a custom `ruler.toml` configuration file          |
 | `--keep-backups`               | Keep backup files (.bak) after restoration (default: false) |
 | `--dry-run`                    | Preview changes without actually reverting files          |
@@ -316,6 +317,10 @@ merge_strategy = "merge"
 # Disable specific agents
 [agents.windsurf]
 enabled = false
+
+[agents.kilocode]
+enabled = true
+output_path = ".kilocode/rules/ruler_kilocode_instructions.md"
 ```
 
 ### Configuration Precedence

package/dist/agents/CursorAgent.js

@@ -49,9 +49,13 @@ class CursorAgent {
     async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
     agentConfig) {
         const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
+        // Cursor expects a YAML front-matter block with an `alwaysApply` flag.
+        // See: https://docs.cursor.com/context/rules#rule-anatomy
+        const frontMatter = ['---', 'alwaysApply: true', '---', ''].join('\n');
+        const content = `${frontMatter}${concatenatedRules.trimStart()}`;
         await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(output));
         await (0, FileSystemUtils_1.backupFile)(output);
-        await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(output, content);
     }
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, '.cursor', 'rules', 'ruler_cursor_instructions.mdc');

package/dist/agents/KiloCodeAgent.js

@@ -0,0 +1,64 @@
+"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.KiloCodeAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * Kilo Code agent adapter.
+ * Generates ruler_kilocode_instructions.md configuration file in .kilocode/rules/ directory.
+ */
+class KiloCodeAgent {
+    getIdentifier() {
+        return 'kilocode';
+    }
+    getName() {
+        return 'Kilo Code';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
+    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, '.kilocode', 'rules', 'ruler_kilocode_instructions.md');
+    }
+    getMcpServerKey() {
+        return 'mcpServers';
+    }
+}
+exports.KiloCodeAgent = KiloCodeAgent;

package/dist/cli/commands.js

@@ -60,7 +60,7 @@ function run() {
         });
         y.option('agents', {
             type: 'string',
-            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie',
+            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, kilocode',
         });
         y.option('config', {
             type: 'string',
@@ -174,7 +174,7 @@ and apply them to your configured AI coding agents.
 
 # --- Agent Specific Configurations ---
 # You can enable/disable agents and override their default output paths here.
-# Use lowercase agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider
+# Use lowercase agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, kilocode
 
 # [agents.copilot]
 # enabled = true
@@ -211,6 +211,10 @@ and apply them to your configured AI coding agents.
 
 # [agents.gemini-cli]
 # enabled = true
+
+# [agents.kilocode]
+# enabled = true
+# output_path = ".kilocode/rules/ruler_kilocode_instructions.md"
 `;
         if (!(await exists(instructionsPath))) {
             await fs_1.promises.writeFile(instructionsPath, DEFAULT_INSTRUCTIONS);
@@ -250,7 +254,7 @@ and apply them to your configured AI coding agents.
         });
         y.option('agents', {
             type: 'string',
-            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie',
+            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, kilocode',
         });
         y.option('config', {
             type: 'string',

package/dist/lib.js

@@ -53,6 +53,7 @@ const GeminiCliAgent_1 = require("./agents/GeminiCliAgent");
 const JulesAgent_1 = require("./agents/JulesAgent");
 const JunieAgent_1 = require("./agents/JunieAgent");
 const AugmentCodeAgent_1 = require("./agents/AugmentCodeAgent");
+const KiloCodeAgent_1 = require("./agents/KiloCodeAgent");
 const merge_1 = require("./mcp/merge");
 const validate_1 = require("./mcp/validate");
 const mcp_1 = require("./paths/mcp");
@@ -106,6 +107,7 @@ const agents = [
     new JulesAgent_1.JulesAgent(),
     new JunieAgent_1.JunieAgent(),
     new AugmentCodeAgent_1.AugmentCodeAgent(),
+    new KiloCodeAgent_1.KiloCodeAgent(),
 ];
 /**
  * Applies ruler configurations for all supported AI agents.

package/dist/paths/mcp.js

@@ -77,6 +77,9 @@ async function getNativeMcpPath(adapterName, projectRoot) {
         case 'AugmentCode':
             candidates.push(path.join(projectRoot, '.vscode', 'settings.json'));
             break;
+        case 'Kilo Code':
+            candidates.push(path.join(projectRoot, '.kilocode', 'mcp.json'));
+            break;
         default:
             return null;
     }

package/dist/revert.js

@@ -51,6 +51,7 @@ const GeminiCliAgent_1 = require("./agents/GeminiCliAgent");
 const JulesAgent_1 = require("./agents/JulesAgent");
 const JunieAgent_1 = require("./agents/JunieAgent");
 const AugmentCodeAgent_1 = require("./agents/AugmentCodeAgent");
+const KiloCodeAgent_1 = require("./agents/KiloCodeAgent");
 const mcp_1 = require("./paths/mcp");
 const constants_1 = require("./constants");
 const settings_1 = require("./vscode/settings");
@@ -68,6 +69,7 @@ const agents = [
     new JulesAgent_1.JulesAgent(),
     new JunieAgent_1.JunieAgent(),
     new AugmentCodeAgent_1.AugmentCodeAgent(),
+    new KiloCodeAgent_1.KiloCodeAgent(),
 ];
 /**
  * Gets all output paths for an agent, taking into account any config overrides.
@@ -280,6 +282,7 @@ async function removeEmptyDirectories(projectRoot, verbose, dryRun) {
         '.gemini',
         '.vscode',
         '.augmentcode',
+        '.kilocode',
     ];
     let directoriesRemoved = 0;
     // Handle .augment directory with special logic
@@ -304,6 +307,7 @@ async function removeAdditionalAgentFiles(projectRoot, verbose, dryRun) {
         '.mcp.json',
         '.vscode/mcp.json',
         '.cursor/mcp.json',
+        '.kilocode/mcp.json',
         '.openhands/config.toml',
     ];
     let filesRemoved = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectronica/ruler",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {