rulesync
Unified AI agent configuration CLI — generates configs for Claude Code skills, hooks, and subagents
Rulesync is a Node.js CLI tool designed to streamline configuration management for various AI coding agents. It solves the problem of fragmented configurations by generating tool-specific files from a single set of unified AI rule files. The utility supports a wide range of features including rules, ignore files, MCP, commands, subagents, skills, hooks, and permissions, integrating with over 20 AI development tools like Claude Code, Cursor, and GitHub Copilot.
- Generates configuration files for AI tools from unified rule files
- Supports selective generation for specific tools and features
- Imports existing configurations from CLAUDE.md, .cursorrules
- Manages rules, ignore files, MCP, commands, subagents, and skills
- Integrates with Claude Code, Gemini CLI, Cursor, and GitHub Copilot
README
View on GitHub ↗
Rulesync
A Node.js CLI tool that automatically generates configuration files for various AI development tools from unified AI rule files. Features selective generation, comprehensive import/export capabilities, and supports major AI development tools with rules, commands, MCP, ignore files, subagents and skills.
[!NOTE] If you are interested in Rulesync latest news, please follow the maintainer's X(Twitter) account: @dyoshikawa1993
Installation
npm install -g rulesync
# or
brew install rulesync
Single Binary
curl -fsSL https://github.com/dyoshikawa/rulesync/releases/latest/download/install.sh | bash
See Installation docs for manual install and platform-specific instructions.
Getting Started
# Create necessary directories, sample rule files, and configuration file
rulesync init
# Install official skills (recommended)
rulesync fetch dyoshikawa/rulesync --features skills
# Generate unified configurations with all features
rulesync generate --targets "*" --features "*"
If you already have AI tool configurations:
# Import existing files (to .rulesync/**/*)
rulesync import --targets claudecode # From CLAUDE.md
rulesync import --targets cursor # From .cursorrules
rulesync import --targets copilot # From .github/copilot-instructions.md
See Quick Start guide for more details.
Supported Tools and Features
| Tool | --targets | rules | ignore | mcp | commands | subagents | skills | hooks | permissions |
|---|---|---|---|---|---|---|---|---|---|
| AGENTS.md | agentsmd | ✅ | 🎮 | 🎮 | 🎮 | ||||
| AgentsSkills | agentsskills | ✅ | |||||||
| Claude Code | claudecode | ✅ 🌏 | ✅ | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 |
| Codex CLI | codexcli | ✅ 🌏 | ✅ 🌏 🔧 | 🌏 | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | |
| Gemini CLI | geminicli | ✅ 🌏 | ✅ | ✅ 🌏 | ✅ 🌏 | ✅ | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 |
| Goose | goose | ✅ 🌏 | ✅ | ||||||
| GitHub Copilot | copilot | ✅ 🌏 | ✅ | ✅ | ✅ | ✅ | ✅ | ||
| GitHub Copilot CLI | copilotcli | ✅ 🌏 | ✅ 🌏 | ||||||
| Cursor | cursor | ✅ | ✅ | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | ✅ | |
| deepagents-cli | deepagents | ✅ | ✅ 🌏 | ✅ | ✅ | 🌏 | |||
| Factory Droid | factorydroid | ✅ 🌏 | ✅ 🌏 | 🎮 | 🎮 | 🎮 | ✅ 🌏 | ||
| OpenCode | opencode | ✅ 🌏 | ✅ 🌏 🔧 | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | ✅ 🌏 | |
| Cline | cline | ✅ | ✅ | ✅ | ✅ 🌏 | ✅ 🌏 | |||
| Kilo Code | kilo | ✅ 🌏 | ✅ | ✅ | ✅ 🌏 | ✅ 🌏 | |||
| Roo Code | roo | ✅ | ✅ | ✅ | ✅ | 🎮 | ✅ 🌏 | ||
| Rovodev (Atlassian) | rovodev | ✅ 🌏 | 🌏 | ✅ 🌏 | ✅ 🌏 | ||||
| Qwen Code | qwencode | ✅ | ✅ | ||||||
| Kiro | kiro | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Google Antigravity | antigravity | ✅ | ✅ | ✅ 🌏 | |||||
| JetBrains Junie | junie | ✅ | ✅ | ✅ | ✅ 🌏 | ✅ | ✅ | ||
| AugmentCode | augmentcode | ✅ | ✅ | ||||||
| Windsurf | windsurf | ✅ | ✅ | ||||||
| Warp | warp | ✅ | |||||||
| Replit | replit | ✅ | ✅ | ||||||
| Zed | zed | ✅ |
- ✅: Supports project mode
- 🌏: Supports global mode
- 🎮: Supports simulated commands/subagents/skills (Project mode only)
- 🔧: Supports MCP tool config (
enabledTools/disabledTools)
Some features accept per-feature options (e.g., Claude Code's ignore feature supports fileMode: "local" to write to settings.local.json instead of settings.json). See Configuration > Per-feature options for details.
Documentation
For full documentation including configuration, CLI reference, file formats, programmatic API, and more, visit the documentation site.
License
MIT License
Similar other
MiroFish
Swarm intelligence engine for future prediction — simulates multi-agent interactions to deduce outcomes
paperclip
AI agent orchestration server for autonomous companies — manages teams of bots, goals, budgets, and governance
learn-claude-code
Agent harness engineering tutorial — build the environment and tools for real LLM agents, inspired by Claude Code
LightRAG
Lightweight RAG framework — builds simple, fast, and scalable retrieval-augmented generation systems for LLMs