rulesync 6.8.1 → 7.0.0

package/README.md

@@ -147,34 +147,33 @@ rulesync generate --targets "*" --features "*"
 
 Rulesync supports both **generation** and **import** for All of the major AI coding tools:
 
-| Tool               | rules | ignore |   mcp    | commands | subagents | skills | hooks |
-| ------------------ | :---: | :----: | :------: | :------: | :-------: | :----: | :---: |
-| AGENTS.md          |  ✅   |        |          |    🎮    |    🎮     |   🎮   |       |
-| AgentsSkills       |       |        |          |          |           |   ✅   |       |
-| Claude Code        | ✅ 🌏 |   ✅   | ✅ 🌏 📦 |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  |  ✅   |
-| Codex CLI          | ✅ 🌏 |        |    🌏    |    🌏    |    🎮     | ✅ 🌏  |       |
-| Gemini CLI         | ✅ 🌏 |   ✅   |  ✅ 🌏   |  ✅ 🌏   |    🎮     | ✅ 🌏  |       |
-| GitHub Copilot     |  ✅   |        |    ✅    |    ✅    |    ✅     |   ✅   |       |
-| Cursor             |  ✅   |   ✅   |    ✅    |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  |  ✅   |
-| Factory Droid      | ✅ 🌏 |        |  ✅ 🌏   |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  |       |
-| OpenCode           |  ✅   |        |    ✅    |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  |       |
-| Cline              |  ✅   |   ✅   |    ✅    |  ✅ 🌏   |           |        |       |
-| Kilo Code          | ✅ 🌏 |   ✅   |    ✅    |  ✅ 🌏   |           | ✅ 🌏  |       |
-| Roo Code           |  ✅   |   ✅   |    ✅    |    ✅    |    🎮     | ✅ 🌏  |       |
-| Qwen Code          |  ✅   |   ✅   |          |          |           |        |       |
-| Kiro               |  ✅   |   ✅   |    ✅    |    ✅    |    ✅     |   ✅   |       |
-| Google Antigravity |  ✅   |        |          |    ✅    |           | ✅ 🌏  |       |
-| JetBrains Junie    |  ✅   |   ✅   |    ✅    |          |           |        |       |
-| AugmentCode        |  ✅   |   ✅   |          |          |           |        |       |
-| Windsurf           |  ✅   |   ✅   |          |          |           |        |       |
-| Warp               |  ✅   |        |          |          |           |        |       |
-| Replit             |  ✅   |        |          |          |           |   ✅   |       |
-| Zed                |       |   ✅   |          |          |           |        |       |
+| Tool               | rules | ignore |  mcp  | commands | subagents | skills | hooks |
+| ------------------ | :---: | :----: | :---: | :------: | :-------: | :----: | :---: |
+| AGENTS.md          |  ✅   |        |       |    🎮    |    🎮     |   🎮   |       |
+| AgentsSkills       |       |        |       |          |           |   ✅   |       |
+| Claude Code        | ✅ 🌏 |   ✅   | ✅ 🌏 |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  |  ✅   |
+| Codex CLI          | ✅ 🌏 |        |  🌏   |    🌏    |    🎮     | ✅ 🌏  |       |
+| Gemini CLI         | ✅ 🌏 |   ✅   | ✅ 🌏 |  ✅ 🌏   |    🎮     | ✅ 🌏  |       |
+| GitHub Copilot     |  ✅   |        |  ✅   |    ✅    |    ✅     |   ✅   |       |
+| Cursor             |  ✅   |   ✅   |  ✅   |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  |  ✅   |
+| Factory Droid      | ✅ 🌏 |        | ✅ 🌏 |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  |       |
+| OpenCode           |  ✅   |        |  ✅   |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  | ✅ 🌏 |
+| Cline              |  ✅   |   ✅   |  ✅   |  ✅ 🌏   |           |        |       |
+| Kilo Code          | ✅ 🌏 |   ✅   |  ✅   |  ✅ 🌏   |           | ✅ 🌏  |       |
+| Roo Code           |  ✅   |   ✅   |  ✅   |    ✅    |    🎮     | ✅ 🌏  |       |
+| Qwen Code          |  ✅   |   ✅   |       |          |           |        |       |
+| Kiro               |  ✅   |   ✅   |  ✅   |    ✅    |    ✅     |   ✅   |       |
+| Google Antigravity |  ✅   |        |       |    ✅    |           | ✅ 🌏  |       |
+| JetBrains Junie    |  ✅   |   ✅   |  ✅   |          |           |        |       |
+| AugmentCode        |  ✅   |   ✅   |       |          |           |        |       |
+| Windsurf           |  ✅   |   ✅   |       |          |           |        |       |
+| Warp               |  ✅   |        |       |          |           |        |       |
+| Replit             |  ✅   |        |       |          |           |   ✅   |       |
+| Zed                |       |   ✅   |       |          |           |        |       |
 
 - ✅: Supports project mode
 - 🌏: Supports global mode
 - 🎮: Supports simulated commands/subagents/skills (Project mode only)
-- 📦: Supports modular MCP (Experimental)
 
 ## Why Rulesync?
 
@@ -400,7 +399,6 @@ Example:
   "simulateCommands": false, // Generate simulated commands
   "simulateSubagents": false, // Generate simulated subagents
   "simulateSkills": false, // Generate simulated skills
-  "modularMcp": false, // Enable modular-mcp for context compression (experimental, Claude Code only)
 }
 ```
 
@@ -495,15 +493,17 @@ This is Rulesync, a Node.js CLI tool that automatically generates configuration
 
 ### `.rulesync/hooks.json`
 
-Hooks run scripts at lifecycle events (e.g. session start, before tool use). Events use **canonical camelCase** in this file; Cursor uses them as-is; Claude Code gets PascalCase in `.claude/settings.json`.
+Hooks run scripts at lifecycle events (e.g. session start, before tool use). Events use **canonical camelCase** in this file; Cursor uses them as-is; Claude Code gets PascalCase in `.claude/settings.json`; OpenCode hooks are generated as a JavaScript plugin at `.opencode/plugins/rulesync-hooks.js`.
 
 **Event support:**
 
-- **Shared (Cursor and Claude):** `sessionStart`, `sessionEnd`, `preToolUse`, `postToolUse`, `beforeSubmitPrompt`, `stop`, `subagentStop`, `preCompact`
-- **Cursor-only:** `postToolUseFailure`, `subagentStart`, `beforeShellExecution`, `afterShellExecution`, `beforeMCPExecution`, `afterMCPExecution`, `beforeReadFile`, `afterFileEdit`, `afterAgentResponse`, `afterAgentThought`, `beforeTabFileRead`, `afterTabFileEdit`
-- **Claude-only:** `permissionRequest`, `notification`, `setup`
+- **Cursor:** `sessionStart`, `preToolUse`, `postToolUse`, `stop`, `sessionEnd`, `beforeSubmitPrompt`, `subagentStop`, `preCompact`, `afterFileEdit`, `afterShellExecution`, `postToolUseFailure`, `subagentStart`, `beforeShellExecution`, `beforeMCPExecution`, `afterMCPExecution`, `beforeReadFile`, `afterAgentResponse`, `afterAgentThought`, `beforeTabFileRead`, `afterTabFileEdit`
+- **Claude Code:** `sessionStart`, `preToolUse`, `postToolUse`, `stop`, `sessionEnd`, `beforeSubmitPrompt`, `subagentStop`, `preCompact`, `permissionRequest`, `notification`, `setup`
+- **OpenCode:** `sessionStart`, `preToolUse`, `postToolUse`, `stop`, `afterFileEdit`, `afterShellExecution`, `permissionRequest`
 
-Use optional **override keys** so tool-specific events and config live in one file without leaking to the other: `cursor.hooks` for Cursor-only events, `claudecode.hooks` for Claude-only. Events in shared `hooks` that a tool does not support are skipped for that tool (and a warning is logged at generate time).
+> **Note:** Rulesync implements OpenCode hooks as a plugin, so importing from OpenCode to rulesync is not supported. OpenCode only supports command-type hooks (not prompt-type).
+
+Use optional **override keys** so tool-specific events and config live in one file without leaking to others: `cursor.hooks` for Cursor-only events, `claudecode.hooks` for Claude-only, `opencode.hooks` for OpenCode-only. Events in shared `hooks` that a tool does not support are skipped for that tool (and a warning is logged at generate time).
 
 Example:
 
@@ -526,6 +526,11 @@ Example:
         { "matcher": "permission_prompt", "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/notify.sh" }
       ]
     }
+  },
+  "opencode": {
+    "hooks": {
+      "afterShellExecution": [{ "command": ".rulesync/hooks/post-shell.sh" }]
+    }
   }
 }
 ```
@@ -759,151 +764,6 @@ Simulated commands, subagents and skills allow you to generate simulated feature
      Use the skill your-skill to achieve something.
      ```
 
-## Modular MCP (Deprecated)
-
-Rulesync supports compressing tokens consumed by MCP servers [d-kimuson/modular-mcp](https://github.com/d-kimuson/modular-mcp) for context saving. When enabled with `--modular-mcp`, it additionally generates `modular-mcp.json`.
-
-```bash
-# Enable modular-mcp via CLI
-rulesync generate --targets claudecode --features mcp --modular-mcp
-
-# Or via configuration file
-{
-  "modularMcp": true
-}
-```
-
-When enabling modular-mcp, each MCP server must have a `description` field. Example:
-
-```diff
-// .rulesync/mcp.json
-{
-  "mcpServers": {
-    "context7": {
-+     "description": "Up-to-date documentation and code examples for libraries",
-      "type": "stdio",
-      "command": "npx",
-      "args": [
-        "-y",
-        "@upstash/context7-mcp"
-      ],
-      "env": {}
-    }
-}
-```
-
-You can also configure `exposed` to exclude specific MCP servers from modular-mcp. It is optional and default to `false`. If you specify `exposed: true`, the MCP server is always loaded in the initial context.
-
-```diff
-// .rulesync/mcp.json
-{
-  "mcpServers": {
-    "context7": {
-+     "exposed": true,
-      "type": "stdio",
-      "command": "npx",
-      "args": [
-        "-y",
-        "@upstash/context7-mcp"
-      ],
-      "env": {}
-    }
-}
-```
-
-To demonstrate the effect of modular-mcp, please see the following example:
-
-<details>
-<summary>Example of effect</summary>
-
-Please see examples using Claude Code.
-
-When using following mcp servers:
-
-```json
-// .rulesync/mcp.json
-
-{
-  "mcpServers": {
-    "serena": {
-      "description": "Semantic coding tools for intelligent codebase exploration and manipulation",
-      "type": "stdio",
-      "command": "uvx",
-      "args": [
-        "--from",
-        "git+https://github.com/oraios/serena",
-        "serena",
-        "start-mcp-server",
-        "--context",
-        "ide-assistant",
-        "--enable-web-dashboard",
-        "false",
-        "--project",
-        "."
-      ],
-      "env": {}
-    },
-    "context7": {
-      "description": "Up-to-date documentation and code examples for libraries",
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp"],
-      "env": {}
-    },
-    "fetch": {
-      "description": "This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.",
-      "type": "stdio",
-      "command": "uvx",
-      "args": ["mcp-server-fetch"],
-      "env": {}
-    }
-  }
-}
-```
-
-Once run `rulesync generate --targets claudecode --features mcp`, `/context` result on Claude Code is as follows:
-
-```
-      Context Usage
-     ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁   claude-sonnet-4-5-20250929 · 82k/200k tokens (41%)
-     ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛀ ⛀
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ System prompt: 2.5k tokens (1.3%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ System tools: 13.9k tokens (6.9%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ MCP tools: 15.7k tokens (7.9%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ Memory files: 5.2k tokens (2.6%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ Messages: 8 tokens (0.0%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛝ ⛝ ⛝   ⛶ Free space: 118k (58.8%)
-     ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝   ⛝ Autocompact buffer: 45.0k tokens (22.5%)
-     ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝
-```
-
-On the other hand, once run `rulesync generate --targets claudecode --features mcp --modular-mcp`, `/context` result on Claude Code is as follows:
-
-```
-      Context Usage
-     ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛀ ⛁   claude-sonnet-4-5-20250929 · 68k/200k tokens (34%)
-     ⛁ ⛀ ⛀ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ System prompt: 2.5k tokens (1.3%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ System tools: 13.5k tokens (6.8%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ MCP tools: 1.3k tokens (0.6%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ Memory files: 5.2k tokens (2.6%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶   ⛁ Messages: 8 tokens (0.0%)
-     ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛝ ⛝ ⛝   ⛶ Free space: 132k (66.2%)
-     ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝   ⛝ Autocompact buffer: 45.0k tokens (22.5%)
-     ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝
-```
-
-Focus on the difference of MCP tools usage.
-
-|                      | Context Usage       |
-| -------------------- | ------------------- |
-| Disabled Modular MCP | 15.7k tokens (7.9%) |
-| Enabled Modular MCP  | 1.3k tokens (0.6%)  |
-
-So, in this case, approximately 92% reduction in MCP tools consumption!
-
-</details>
-
 ## Official Skills
 
 Rulesync provides official skills that you can install using the fetch command:
@@ -964,6 +824,28 @@ According to [the documentation](https://code.claude.com/docs/en/settings), this
 
 > Automatically approve all MCP servers defined in project .mcp.json files
 
+### Q. Google Antigravity doesn't load rules when `.agent` directories are in `.gitignore`
+
+Google Antigravity has a known limitation where it won't load rules, workflows, and skills if the `.agent/rules/`, `.agent/workflows/`, and `.agent/skills/` directories are listed in `.gitignore`, even with "Agent Gitignore Access" enabled.
+
+**Workaround:** Instead of adding these directories to `.gitignore`, add them to `.git/info/exclude`:
+
+```bash
+# Remove from .gitignore (if present)
+# **/.agent/rules/
+# **/.agent/workflows/
+# **/.agent/skills/
+
+# Add to .git/info/exclude
+echo "**/.agent/rules/" >> .git/info/exclude
+echo "**/.agent/workflows/" >> .git/info/exclude
+echo "**/.agent/skills/" >> .git/info/exclude
+```
+
+`.git/info/exclude` works like `.gitignore` but is local-only, so it won't affect Antigravity's ability to load the rules while still excluding these directories from Git.
+
+Note: `.git/info/exclude` can't be shared with your team since it's not committed to the repository.
+
 ## License
 
 MIT License