A Node.js CLI tool that auto-generates configuration files for 20+ AI development tools (Claude Code, Cursor, GitHub Copilot, Gemini CLI, etc.) from unified AI rule files — write once, distribute everywhere. Supports MCP, commands, subagents, skills, and more.
Rulesync is a CLI tool that solves the fragmentation of AI coding assistant rules. In development environments where tools like Claude Code, Cursor, GitHub Copilot, and Gemini CLI coexist, teams often need to repeatedly write instructions and rules across different tools — high maintenance cost and prone to inconsistency.
Core Value#
- Single Source of Truth: Manage rules uniformly in
.rulesync/directory, auto-convert to each tool's native format - Tool Freedom: Developers can freely choose AI assistants without rewriting team standards
- Consistency Guarantee: New members immediately get the same conventions, context, and guardrails
- Auditable Output: Generates pure config files that can be committed, reviewed, and published
Supported Tools Matrix#
Supports configuration generation for 20+ AI development tools: Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex CLI, Cline, OpenCode, Kiro, Windsurf, Zed, and more.
| Feature | Description |
|---|---|
| rules | Rules/instructions config |
| ignore | Ignore file config |
| mcp | Model Context Protocol config |
| commands | Custom commands |
| subagents | Sub-agent config |
| skills | Skill definitions |
| hooks | Hook config |
Key Features#
- Project-level and global-level dual modes
- Reverse import from existing configs (
rulesync import) - CI/CD integration (
--checkmode) - Dry-run preview (
--dry-run) - Selective generation (
--targets/--features)
Installation & Quick Start#
# Install
npm install -g rulesync
# Initialize project
rulesync init
# Install official skills
rulesync fetch dyoshikawa/rulesync --features skills
# Generate all tool configs
rulesync generate --targets "*" --features "*"
Import from Existing Configs#
rulesync import --targets claudecode # From CLAUDE.md
rulesync import --targets cursor # From .cursorrules
rulesync import --targets copilot # From .github/copilot-instructions.md
Common Commands#
| Command | Function |
|---|---|
rulesync init | Initialize new project |
rulesync generate | Generate target tool configs |
rulesync import | Import from existing configs |
rulesync fetch | Install remote skills |
rulesync gitignore | Add generated files to .gitignore |
Implementation Highlights#
- Language: TypeScript (98.8%)
- Runtime: Node.js / Bun
- Package Manager: pnpm
- Testing: Vitest
- Documentation: VitePress