dyoshikawa/rulesync

Rulesync – AI開発ツール向け統合構成生成ツール

何であるか – rulesync は、AIコーディングアシスタント（Claude Code、GitHub Copilot、Cursorなど）が使用する多数の構成ファイルの単一の真実源を維持できる Node.js コマンドラインユーティリティです。「ルール」ファイルのセットから、各対応ツールに必要なネイティブ構成形式を自動的に作成、インポート、エクスポート、または変換できます。

なぜ重要か – 各AIアシスタントは、プロンプトルール、無視リスト、コマンドショートカット、サブエージェント、スキルなどについて独自の JSON/YAML/Markdown レイアウトを持っています。これらを手動で維持するのはエラーを引き起こしやすく、プロジェクト間で同期するのが困難です。Rulesync はこれらの違いを抽象化し、1つの .rulesync/ ツリーを編集して、CLI が各ターゲットに適切なファイルを出力するようにします。

主な機能

• 選択的生成 – rulesync generate --targets "*" --features "*" ですべての対応ファイルを生成できます。特定のツールや機能グループに絞ることも可能です。
• インポート / エクスポート – rulesync import --targets <tool> で既存の構成を統合された .rulesync/ 形式に取り込みます。rulesync fetch で公式「スキル」パッケージを取得できます。
• 直接変換 – rulesync convert --from cursor --to copilot,claudecode で、中間の .rulesync/ ファイルを書かずに、1つのツールの構成を別のツールに変換できます。
• 広範なツール対応 – 30以上のAIコーディングアシスタントおよび関連標準がリストアップされており、各ツールが対応する機能（ルール、無視/権限、MCP、コマンド、サブエージェント、スキル、フック、権限、チェック）を示すマトリクスがあります。
• 非推奨機能の対応 – ignore は permissions に置き換えられるなど、非推奨機能に対応。旧式ツール（例：Roo Code）は互換性エイリアスでサポートされます。
• プログラムAPI – CLI 以外にも、Nodeスクリプトで使用可能な関数をパッケージがエクスポートします（ドキュメントサイトを参照）。

インストール

# グローバル npm インストール
npm install -g rulesync

# Homebrew（macOS / Linux）
brew tap dyoshikawa/rulesync https://github.com/dyoshikawa/rulesync
brew install rulesync

# シングルバイナリインストーラー
curl -fsSL https://github.com/dyoshikawa/rulesync/releases/latest/download/install.sh | bash

通常のワークフロー

# 新規プロジェクトの初期化
rulesync init

# 公式スキルバンドルの取得（推奨）
rulesync fetch dyoshikawa/rulesync

# すべての対応構成ファイルを生成
rulesync generate --targets "*" --features "*"

既にツール固有の構成がある場合は、まずインポートしてください：

rulesync import --targets claudecode   # CLAUDE.md から
rulesync import --targets cursor       # .cursorrules から

対応ツール – READMEには詳細なテーブルが含まれており、注目すべき項目には Claude Code、GitHub Copilot（CLI および UI）、Cursor、Google Antigravity（IDE および CLI）、Kiro（IDE および CLI）、および Hermes、Factory Droid、AugmentCode などの新興エージェントが含まれます。各ツールは9つの機能カラムのサブセットをサポートする可能性があります。

ドキュメントとヘルプ – 完全なリファレンス、インストールガイド、各機能のオプションは https://rulesync.dyoshikawa.com/ でホストされています。プロジェクトは CI バッジ、npm ステータス、コミュニティ「awesome-list」収録の表示もしています。

ライセンス – MIT。

---

すべての詳細はリポジトリの README から直接取得されており、外部の仮定は一切追加されていません。