Rulesync
Rulesync generates and synchronizes AI rule configuration files across 20+ coding tools (Claude Code, Cursor, Copilot, Windsurf, Cline, Gemini CLI, and more) from a single set of unified rule files in .rulesync/.
Quick Start
# Install
npm install -g rulesync
# New project: initialize config, rules, and directory structure
rulesync init
# Import existing AI tool configs into unified format
rulesync import --targets claudecode # From CLAUDE.md
rulesync import --targets cursor # From .cursorrules
rulesync import --targets copilot # From .github/copilot-instructions.md
# Generate tool-specific configs from unified rules
rulesync generate --targets "*" --features "*"
Core Workflow
- Init -
rulesync init creates rulesync.jsonc config and .rulesync/ directory with sample rules
- Write rules - Add shared AI rules in
.rulesync/rules/, MCP configs in .rulesync/mcp/, commands in .rulesync/commands/
- Generate -
rulesync generate produces tool-specific files (CLAUDE.md, .cursorrules, .github/copilot-instructions.md, etc.)
- Verify -
rulesync generate --dry-run previews changes; --check validates files are up to date (useful in CI)
Key Commands
| Command |
Purpose |
rulesync init |
Scaffold project with config and sample rules |
rulesync generate --targets "*" --features "*" |
Generate all tool configs from unified rules |
rulesync import --targets <tool> |
Import existing tool config into unified format |
rulesync fetch owner/repo --features skills |
Fetch rules or skills from a remote repository |
rulesync install |
Install skill sources declared in rulesync.jsonc |
rulesync generate --check |
CI check that generated files are up to date |
rulesync generate --dry-run |
Preview changes without writing files |
Detailed Reference
- Installation, Quick Start
- Why Rulesync?, Configuration, Global Mode, Separate Input Root, Simulated Features, Declarative Sources, Official Skills, Gemini CLI → Antigravity CLI, Dry Run, Case Studies
- Supported Tools, CLI Commands, File Formats, Command Syntax, MCP Server
- Programmatic API
- FAQ
1---2name: rulesync-43description: Generates and syncs AI rule configuration files (.cursorrules, CLAUDE.md, copilot-instructions.md) across 20+ coding tools from a single source. Use when syncing AI rules, running rulesync commands, importing or generating rule files, or managing shared AI coding configurations.4---56# Rulesync78Rulesync generates and synchronizes AI rule configuration files across 20+ coding tools (Claude Code, Cursor, Copilot, Windsurf, Cline, Gemini CLI, and more) from a single set of unified rule files in `.rulesync/`.910## Quick Start1112```bash13# Install14npm install -g rulesync1516# New project: initialize config, rules, and directory structure17rulesync init1819# Import existing AI tool configs into unified format20rulesync import --targets claudecode # From CLAUDE.md21rulesync import --targets cursor # From .cursorrules22rulesync import --targets copilot # From .github/copilot-instructions.md2324# Generate tool-specific configs from unified rules25rulesync generate --targets "*" --features "*"26```2728## Core Workflow29301. **Init** - `rulesync init` creates `rulesync.jsonc` config and `.rulesync/` directory with sample rules312. **Write rules** - Add shared AI rules in `.rulesync/rules/`, MCP configs in `.rulesync/mcp/`, commands in `.rulesync/commands/`323. **Generate** - `rulesync generate` produces tool-specific files (CLAUDE.md, .cursorrules, .github/copilot-instructions.md, etc.)334. **Verify** - `rulesync generate --dry-run` previews changes; `--check` validates files are up to date (useful in CI)3435## Key Commands3637| Command | Purpose |38| ------------------------------------------------ | ------------------------------------------------ |39| `rulesync init` | Scaffold project with config and sample rules |40| `rulesync generate --targets "*" --features "*"` | Generate all tool configs from unified rules |41| `rulesync import --targets <tool>` | Import existing tool config into unified format |42| `rulesync fetch owner/repo --features skills` | Fetch rules or skills from a remote repository |43| `rulesync install` | Install skill sources declared in rulesync.jsonc |44| `rulesync generate --check` | CI check that generated files are up to date |45| `rulesync generate --dry-run` | Preview changes without writing files |4647## Detailed Reference4849- [Installation](./installation.md), [Quick Start](./quick-start.md)50- [Why Rulesync?](./why-rulesync.md), [Configuration](./configuration.md), [Global Mode](./global-mode.md), [Separate Input Root](./separate-input-root.md), [Simulated Features](./simulated-features.md), [Declarative Sources](./declarative-sources.md), [Official Skills](./official-skills.md), [Gemini CLI → Antigravity CLI](./geminicli-to-antigravity-cli.md), [Dry Run](./dry-run.md), [Case Studies](./case-studies.md)51- [Supported Tools](./supported-tools.md), [CLI Commands](./cli-commands.md), [File Formats](./file-formats.md), [Command Syntax](./command-syntax.md), [MCP Server](./mcp-server.md)52- [Programmatic API](./programmatic-api.md)53- [FAQ](./faq.md)
rudironsoni