@intellectronica/ruler 0.3.30 → 0.3.31
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +38 -36
- package/dist/core/FileSystemUtils.js +13 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -54,40 +54,40 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
|
|
|
54
54
|
|
|
55
55
|
## Supported AI Agents
|
|
56
56
|
|
|
57
|
-
| Agent
|
|
58
|
-
|
|
|
59
|
-
| AGENTS.md
|
|
60
|
-
| GitHub Copilot
|
|
61
|
-
| Claude Code
|
|
62
|
-
| OpenAI Codex CLI
|
|
63
|
-
| Pi Coding Agent
|
|
64
|
-
| Jules
|
|
65
|
-
| Cursor
|
|
66
|
-
| Windsurf
|
|
67
|
-
| Cline
|
|
68
|
-
| Crush
|
|
69
|
-
| Amp
|
|
70
|
-
| Antigravity
|
|
71
|
-
| Amazon Q CLI
|
|
72
|
-
| Aider
|
|
73
|
-
| Firebase Studio
|
|
74
|
-
| Open Hands
|
|
75
|
-
| Gemini CLI
|
|
76
|
-
| Junie
|
|
77
|
-
| AugmentCode
|
|
78
|
-
| Kilo Code
|
|
79
|
-
| OpenCode
|
|
80
|
-
| Goose
|
|
81
|
-
| Qwen Code
|
|
82
|
-
| RooCode
|
|
83
|
-
| Zed
|
|
84
|
-
| Trae AI
|
|
85
|
-
| Warp
|
|
86
|
-
| Kiro
|
|
87
|
-
| Firebender
|
|
88
|
-
| Factory Droid
|
|
89
|
-
| Mistral Vibe
|
|
90
|
-
| JetBrains AI Assistant | `.aiassistant/rules/AGENTS.md`
|
|
57
|
+
| Agent | Rules File(s) | MCP Configuration / Notes | Skills Support / Location |
|
|
58
|
+
| ---------------------- | ---------------------------------------------- | ------------------------------------------------ | ------------------------- |
|
|
59
|
+
| AGENTS.md | `AGENTS.md` | (pseudo-agent ensuring root `AGENTS.md` exists) | - |
|
|
60
|
+
| GitHub Copilot | `AGENTS.md` | `.vscode/mcp.json` | `.claude/skills/` |
|
|
61
|
+
| Claude Code | `CLAUDE.md` | `.mcp.json` | `.claude/skills/` |
|
|
62
|
+
| OpenAI Codex CLI | `AGENTS.md` | `.codex/config.toml` | `.codex/skills/` |
|
|
63
|
+
| Pi Coding Agent | `AGENTS.md` | - | `.pi/skills/` |
|
|
64
|
+
| Jules | `AGENTS.md` | - | - |
|
|
65
|
+
| Cursor | `AGENTS.md` | `.cursor/mcp.json` | `.cursor/skills/` |
|
|
66
|
+
| Windsurf | `AGENTS.md` | `.windsurf/mcp_config.json` | - |
|
|
67
|
+
| Cline | `.clinerules` | - | - |
|
|
68
|
+
| Crush | `CRUSH.md` | `.crush.json` | - |
|
|
69
|
+
| Amp | `AGENTS.md` | - | `.agents/skills/` |
|
|
70
|
+
| Antigravity | `.agent/rules/ruler.md` | - | `.agent/skills/` |
|
|
71
|
+
| Amazon Q CLI | `.amazonq/rules/ruler_q_rules.md` | `.amazonq/mcp.json` | - |
|
|
72
|
+
| Aider | `AGENTS.md`, `.aider.conf.yml` | `.mcp.json` | - |
|
|
73
|
+
| Firebase Studio | `.idx/airules.md` | `.idx/mcp.json` | - |
|
|
74
|
+
| Open Hands | `.openhands/microagents/repo.md` | `config.toml` | - |
|
|
75
|
+
| Gemini CLI | `AGENTS.md` | `.gemini/settings.json` | `.gemini/skills/` |
|
|
76
|
+
| Junie | `.junie/guidelines.md` | - | - |
|
|
77
|
+
| AugmentCode | `.augment/rules/ruler_augment_instructions.md` | - | - |
|
|
78
|
+
| Kilo Code | `AGENTS.md` | `.kilocode/mcp.json` | `.claude/skills/` |
|
|
79
|
+
| OpenCode | `AGENTS.md` | `opencode.json` | `.opencode/skill/` |
|
|
80
|
+
| Goose | `.goosehints` | - | `.agents/skills/` |
|
|
81
|
+
| Qwen Code | `AGENTS.md` | `.qwen/settings.json` | - |
|
|
82
|
+
| RooCode | `AGENTS.md` | `.roo/mcp.json` | `.roo/skills/` |
|
|
83
|
+
| Zed | `AGENTS.md` | `.zed/settings.json` (project root, never $HOME) | - |
|
|
84
|
+
| Trae AI | `.trae/rules/project_rules.md` | - | - |
|
|
85
|
+
| Warp | `WARP.md` | - | - |
|
|
86
|
+
| Kiro | `.kiro/steering/ruler_kiro_instructions.md` | `.kiro/settings/mcp.json` | - |
|
|
87
|
+
| Firebender | `firebender.json` | `firebender.json` (rules and MCP in same file) | - |
|
|
88
|
+
| Factory Droid | `AGENTS.md` | `.factory/mcp.json` | `.factory/skills/` |
|
|
89
|
+
| Mistral Vibe | `AGENTS.md` | `.vibe/config.toml` | `.vibe/skills/` |
|
|
90
|
+
| JetBrains AI Assistant | `.aiassistant/rules/AGENTS.md` | - | - |
|
|
91
91
|
|
|
92
92
|
## Getting Started
|
|
93
93
|
|
|
@@ -139,8 +139,8 @@ This is your central hub for all AI agent instructions:
|
|
|
139
139
|
4. Remaining discovered `.md` files under `.ruler/` (and subdirectories) in sorted order
|
|
140
140
|
- **Rule Files (`*.md`)**: Discovered recursively from `.ruler/` or `$XDG_CONFIG_HOME/ruler` and concatenated in the order above
|
|
141
141
|
- **Concatenation Marker**: Each file's content is prepended with `<!-- Source: <relative_path_to_md_file> -->` for traceability
|
|
142
|
-
- **`ruler.toml`**: Master configuration for Ruler's behavior, agent selection, and
|
|
143
|
-
- **`mcp.json`**: Shared MCP server settings
|
|
142
|
+
- **`ruler.toml`**: Master configuration for Ruler's behavior, agent selection, output paths, and MCP server settings
|
|
143
|
+
- **`mcp.json`**: (Legacy, deprecated) Shared MCP server settings - no longer scaffolded but still supported for backward compatibility
|
|
144
144
|
|
|
145
145
|
This ordering lets you keep a short, high-impact root `AGENTS.md` (e.g. executive project summary) while housing detailed guidance inside `.ruler/`.
|
|
146
146
|
|
|
@@ -241,6 +241,8 @@ The `apply` command looks for `.ruler/` in the current directory tree, reading t
|
|
|
241
241
|
| `--nested` | Enable nested rule loading (default: inherit from config or disabled). |
|
|
242
242
|
| `--no-nested` | Disable nested rule loading even if `nested = true` in config. |
|
|
243
243
|
| `--backup` | Toggle creation of `.bak` backup files (default: enabled). |
|
|
244
|
+
| `--skills` | Enable skills support (experimental, default: enabled). |
|
|
245
|
+
| `--no-skills` | Disable skills support. |
|
|
244
246
|
| `--dry-run` | Preview changes without writing files. |
|
|
245
247
|
| `--local-only` | Skip `$XDG_CONFIG_HOME` when looking for configuration. |
|
|
246
248
|
| `--verbose` / `-v` | Display detailed output during execution. |
|
|
@@ -226,6 +226,7 @@ async function findGlobalRulerDir() {
|
|
|
226
226
|
*/
|
|
227
227
|
async function findAllRulerDirs(startPath) {
|
|
228
228
|
const rulerDirs = [];
|
|
229
|
+
const rootPath = path.resolve(startPath);
|
|
229
230
|
// Search the entire directory tree downwards from startPath
|
|
230
231
|
async function findRulerDirs(dir) {
|
|
231
232
|
try {
|
|
@@ -239,6 +240,18 @@ async function findAllRulerDirs(startPath) {
|
|
|
239
240
|
else {
|
|
240
241
|
// Recursively search subdirectories (but skip hidden directories like .git)
|
|
241
242
|
if (!entry.name.startsWith('.')) {
|
|
243
|
+
// Do not cross git repository boundaries (except the starting root)
|
|
244
|
+
const gitDir = path.join(fullPath, '.git');
|
|
245
|
+
try {
|
|
246
|
+
const gitStat = await fs_1.promises.stat(gitDir);
|
|
247
|
+
if (gitStat.isDirectory() &&
|
|
248
|
+
path.resolve(fullPath) !== rootPath) {
|
|
249
|
+
continue;
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
catch {
|
|
253
|
+
// no .git boundary, continue traversal
|
|
254
|
+
}
|
|
242
255
|
await findRulerDirs(fullPath);
|
|
243
256
|
}
|
|
244
257
|
}
|