An open API service indexing awesome lists of open source software.

https://github.com/dyoshikawa/rulesync

A Utility CLI for AI Coding Agents
https://github.com/dyoshikawa/rulesync

ai ai-agents ai-coding llm mcp rules skills

Last synced: 3 months ago
JSON representation

A Utility CLI for AI Coding Agents

Awesome Lists containing this project

README

          


Rulesync Logo

# Rulesync

[![CI](https://github.com/dyoshikawa/rulesync/actions/workflows/ci.yml/badge.svg)](https://github.com/dyoshikawa/rulesync/actions/workflows/ci.yml)
[![npm version](https://img.shields.io/npm/v/rulesync)](https://www.npmjs.com/package/rulesync)
[![npm downloads](https://img.shields.io/npm/dt/rulesync)](https://www.npmjs.com/package/rulesync)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/dyoshikawa/rulesync)
[![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code)
[![Mentioned in Awesome Gemini CLI](https://awesome.re/mentioned-badge.svg)](https://github.com/Piebald-AI/awesome-gemini-cli)

**[Documentation](https://dyoshikawa.github.io/rulesync/)** | **[npm](https://www.npmjs.com/package/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](https://x.com/dyoshikawa1993)

## Installation

```bash
npm install -g rulesync
# or
brew install rulesync
```

### Single Binary

```bash
curl -fsSL https://github.com/dyoshikawa/rulesync/releases/latest/download/install.sh | bash
```

See [Installation docs](https://dyoshikawa.github.io/rulesync/getting-started/installation) for manual install and platform-specific instructions.

## Getting Started

```bash
# 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:

```bash
# 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
```

Want to convert configuration from one AI tool to another directly, without
adopting the `.rulesync/` source-of-truth workflow?

```bash
# Convert Cursor rules to Copilot and Claude Code in one shot (no .rulesync/ files written)
rulesync convert --from cursor --to copilot,claudecode
```

See [Quick Start guide](https://dyoshikawa.github.io/rulesync/getting-started/quick-start) 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 | โœ… ๐ŸŒ | | ๐ŸŒ | | โœ… ๐ŸŒ | โœ… ๐ŸŒ | | |
| Takt | takt | โœ… ๐ŸŒ | | | โœ… ๐ŸŒ | โœ… ๐ŸŒ | โœ… ๐ŸŒ | | |
| Qwen Code | qwencode | โœ… | โœ… | | | | | | |
| Kiro | kiro | โœ… | โœ… | โœ… | โœ… | โœ… | โœ… | | โœ… |
| Google Antigravity | antigravity | โœ… | | | โœ… | | โœ… ๐ŸŒ | | |
| JetBrains Junie | junie | โœ… | โœ… | โœ… | โœ… ๐ŸŒ | โœ… | โœ… | | |
| AugmentCode | augmentcode | โœ… | โœ… | | | | | | |
| Windsurf | windsurf | โœ… | โœ… | | | | โœ… ๐ŸŒ | | |
| Warp | warp | โœ… | | | | | | | |
| Replit | replit | โœ… | | | | | โœ… | | |
| Pi Coding Agent | pi | โœ… ๐ŸŒ | | | โœ… ๐ŸŒ | | โœ… ๐ŸŒ | | |
| 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](https://dyoshikawa.github.io/rulesync/guide/configuration#per-feature-options) for details.

## Documentation

For full documentation including configuration, CLI reference, file formats, programmatic API, and more, visit the **[documentation site](https://dyoshikawa.github.io/rulesync/)**.

## License

MIT License