dyoshikawa/rulesync

Rulesync – Unified configuration generator for AI development tools

What it is – rulesync is a Node‑JS command‑line utility that lets you keep a single source‑of‑truth for the many configuration files used by AI‑coding assistants (Claude Code, GitHub Copilot, Cursor, etc.). From a set of “rule” files you can automatically create, import, export, or convert the native config formats required by each supported tool.

Why it matters – Each AI assistant has its own JSON/YAML/Markdown layout for things like prompt rules, ignore lists, command shortcuts, sub‑agents, and skills. Maintaining them manually is error‑prone and hard to keep in sync across projects. Rulesync abstracts those differences, so you edit one .rulesync/ tree and let the CLI emit the correct files for every target.

Key features

• Selective generation – rulesync generate --targets "*" --features "*" creates every supported file, or you can narrow the list to specific tools or feature groups.
• Import / export – rulesync import --targets <tool> pulls existing configs into the unified .rulesync/ format; rulesync fetch can pull official “skills” packages.
• Direct conversion – rulesync convert --from cursor --to copilot,claudecode translates one tool’s config to another without writing the intermediate .rulesync/ files.
• Broad tool support – Over 30 AI coding assistants and related standards are listed, with a matrix indicating which features (rules, ignore/permissions, MCP, commands, sub‑agents, skills, hooks, permissions, checks) are handled for each.
• Deprecation handling – Features like ignore are phased out in favor of permissions; legacy tools (e.g., Roo Code) are still supported via compatibility aliases.
• Programmatic API – Besides the CLI, the package exports functions for use in Node scripts (see the documentation site).

Installation

# Global npm install
npm install -g rulesync

# Homebrew (macOS / Linux)
brew tap dyoshikawa/rulesync https://github.com/dyoshikawa/rulesync
brew install rulesync

# Single‑binary installer
curl -fsSL https://github.com/dyoshikawa/rulesync/releases/latest/download/install.sh | bash

Typical workflow

# Initialise a new project
rulesync init

# Pull official skill bundles (recommended)
rulesync fetch dyoshikawa/rulesync

# Generate all supported configuration files
rulesync generate --targets "*" --features "*"

If you already have tool‑specific configs, import them first:

rulesync import --targets claudecode   # from CLAUDE.md
rulesync import --targets cursor       # from .cursorrules

Supported tools – The README includes a detailed table; notable entries include Claude Code, GitHub Copilot (CLI & UI), Cursor, Google Antigravity (IDE & CLI), Kiro (IDE & CLI), and many emerging agents such as Hermes, Factory Droid, and AugmentCode. Each tool may support a subset of the nine feature columns.

Documentation & help – Full reference, installation guides, and per‑feature options are hosted at https://rulesync.dyoshikawa.com/. The project also shows badges for CI, npm stats, and mentions in community “awesome‑list” collections.

License – MIT.

---

All details are taken directly from the repository’s README; no external assumptions have been added.