rulesync

Q: 如何一次性为所有 AI 工具生成配置？

使用 rulesync generate --targets ＂*＂ --features ＂*＂，星号表示对所有支持的目标工具和全部功能生成配置。

一键同步 AI 编码规则，多代理配置不再乱

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 171 🐛 待处理 65 👀 关注 1

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1589

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类智能体

开发团队dyoshikawa

官网地址http://rulesync.dyoshikawa.com

GitHubhttps://github.com/dyoshikawa/rulesync

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,ai-agents,ai-coding,llm,mcp,rules,skills

GitHub 星标★ 1589

上线时间2025-06-18 00:00:00

代码更新2026-11-07

仓库体积43.5 MB

本站数据更新2026-11-07

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

rulesync 是一个为 AI 编码代理设计的实用命令行工具，主要解决 AI 编程时规则和技能文件同步与管理混乱的问题。它能够帮助开发者将项目中的规则文件（如 .cursorrules、AGENTS.md 等）和技能配置统一同步到 AI 代理的工作目录，确保不同代理（如 Cursor、Claude Code 等）使用一致的规则。核心能力包括规则文件的集中管理、自动同步、版本控制集成，以及通过 MCP 协议与 AI 代理无缝对接。它简化了多项目、多代理环境下的配置维护流程，让开发者可以更专注于编码本身，而不是反复复制粘贴规则文件。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1589

技术标签

ai ai-agents ai-coding llm mcp

使用教程

难度：入门约 5 分钟部署方式：命令行工具 6 步

环境要求

Node.js 环境（用于 npm 全局安装）
macOS 或 Linux（使用 Homebrew 安装方式时）
可访问 npm 源与 GitHub Releases（下载安装脚本）

安装与启动步骤

1npm 全局安装

README 首选安装方式，通过 npm 将 rulesync 安装为全局命令行工具，安装后可在任意目录调用 rulesync 命令。
```
npm install -g rulesync
```
2Homebrew 安装替代

macOS/Linux 用户也可用 Homebrew 安装。必须先执行两参数的 brew tap，再用 brew install 安装。
```
brew tap dyoshikawa/rulesync https://github.com/dyoshikawa/rulesync
brew install rulesync
```
3单二进制安装

不想用包管理器时，可执行官方安装脚本下载最新 Release 的单文件二进制版本。
```
curl -fsSL https://github.com/dyoshikawa/rulesync/releases/latest/download/install.sh | bash
```
4初始化项目

在项目根目录执行，创建必要目录、示例规则文件和配置文件，是后续生成配置的基础。
```
rulesync init
```
5拉取官方技能

README 推荐的步骤，从官方仓库获取官方 skills 到本地，供后续生成时使用。
```
rulesync fetch dyoshikawa/rulesync
```
6生成代理配置

用通配符一次性为所有支持的目标工具和全部功能生成统一配置，如规则、命令、MCP、忽略文件等。
```
rulesync generate --targets "*" --features "*"
```

如何确认成功

执行 rulesync generate 后，项目目录中出现对应 AI 开发工具的规则/配置文件即视为生成成功。

常见问题

Q：brew install dyoshikawa/rulesync/rulesync 为什么失败？

A：该 tap 位于 rulesync 仓库内，没有 homebrew- 前缀，简写形式不可用。必须先执行 brew tap dyoshikawa/rulesync https://github.com/dyoshikawa/rulesync 再安装。

Q：如何一次性为所有 AI 工具生成配置？

A：使用 rulesync generate --targets "*" --features "*"，星号表示对所有支持的目标工具和全部功能生成配置。

Q：安装后该先做什么？

A：建议依次执行 rulesync init 创建目录与配置文件，再执行 rulesync fetch dyoshikawa/rulesync 安装官方 skills。

注意事项

Homebrew 安装必须使用两参数形式的 brew tap，不能用简写命令。
单二进制安装脚本从 GitHub Releases 拉取最新版本，需要网络可访问 GitHub。
更多手动安装及各平台细节请查阅官方安装文档 https://rulesync.dyoshikawa.com/getting-started/installation。