dyoshikawa/rulesync

Rulesync – AI 개발 도구용 통합 구성 생성기

무엇인가요 – rulesync 는 AI 코딩 어시스턴트(Claude Code, GitHub Copilot, Cursor 등)가 사용하는 여러 구성 파일의 단일 진실 소스를 유지할 수 있는 Node.js 명령줄 유틸리티입니다. "규칙" 파일 세트를 기반으로 각 지원 도구에 필요한 네이티브 구성 형식을 자동으로 생성, 가져오기, 내보내기, 또는 변환할 수 있습니다.

왜 중요한가요 – 각 AI 어시스턴트는 프롬프트 규칙, 무시 목록, 명령 단축키, 서브 에이전트, 기술 등에 대해 고유한 JSON/YAML/Markdown 구조를 가지고 있습니다. 이를 수동으로 유지하는 것은 실수를 유발하고 프로젝트 간 동기화가 어렵습니다. Rulesync 는 이러한 차이를 추상화하여, 하나의 .rulesync/ 트리만 편집하고 CLI 가 모든 대상에 맞는 파일을 생성하도록 합니다.

주요 기능

• 선택적 생성 – rulesync generate --targets "*" --features "*" 는 모든 지원 파일을 생성할 수 있으며, 특정 도구나 기능 그룹으로 목록을 좁힐 수도 있습니다.
• 가져오기 / 내보내기 – rulesync import --targets <tool> 는 기존 구성 파일을 통합된 .rulesync/ 형식으로 가져옵니다. rulesync fetch 는 공식 "기술" 패키지를 다운로드할 수 있습니다.
• 직접 변환 – rulesync convert --from cursor --to copilot,claudecode 는 중간 .rulesync/ 파일을 작성하지 않고도 한 도구의 구성 파일을 다른 도구로 변환할 수 있습니다.
• 광범위한 도구 지원 – 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에서 직접 가져왔으며, 외부 가정은 추가되지 않았습니다.