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 templates
learn-claude-code
Agent harness engineering tutorial — build the environment and tools for real LLM agents, inspired by Claude Code
claude-code-templates
Claude Code template manager — CLI to browse, install, and monitor agents, commands, and MCPs
claude-code-system-prompts
Claude Code system prompts — up-to-date collection of all internal prompts for subagents, tools, and utilities
claude-code-infrastructure-showcase
Claude Code infrastructure showcase for auto-activating skills, modular patterns, and specialized agents