Rulesify

# Rulesify

Rulesify is a command-line tool (written in Rust) that provides **unified management of AI assistant rules** across multiple platforms. Create rules once in Universal Rule Format (URF), then deploy them everywhere.

## Supported AI Tools

- **Cursor** (`.cursor/rules/*.mdc` — Markdown with YAML frontmatter)
- **Cline** (`.clinerules/*.md` — Simple Markdown files)
- **Claude Code** (`<rule-name>.md` — Markdown files in project root)
- **Goose** (`<rule-name>.goosehints` — Plain text files in project root)

**File Generation Details:**
- Generated tool files are automatically Git-ignored
- Only edit URF files (`.urf.yaml`) - tool files are regenerated on deployment
- Each tool has specific format requirements that are handled automatically
- Round-trip integrity: URF → tool file → URF maintains all information

## Features

- **Rule Management**: Create, edit, list, show, and delete rules
- **Multi-Tool Deployment**: Deploy rules to all supported AI tools
- **Import Functionality**: Import existing rules from any AI tool format
- **Validation System**: Comprehensive quality and format validation
- **Template System**: Create rules from built-in templates
- **Configuration Management**: Flexible storage and configuration options
- **Sync**: Synchronize deployed rules back to URF format
- **Round-Trip Integrity**: Import/export cycle is lossless and auto-validated
- **Unicode Support**: Handles international text
- **Comprehensive Testing**: 75 tests, 100% pass rate

## Installation

### One-liner (Recommended)

Run this command to install the latest stable release:

```bash
curl -sSL https://github.com/ihelio/rulesify/releases/latest/download/install.sh | bash
```

- This script detects your OS/architecture, downloads the correct binary, installs it to `~/.local/bin`, and adds it to your `PATH` if needed.
- After installation, restart your shell or run:
  ```bash
  export PATH="$HOME/.local/bin:$PATH"
  ```

### Installing Edge Releases

Edge releases are pre-release builds from the latest merged commit on the default branch. They allow you to test the newest changes without waiting for a production tag.

**Install latest edge release (moving tag `edge`):**
```bash
curl -sSL https://github.com/ihelio/rulesify/releases/latest/download/install.sh | bash -s -- --edge
```

**Install a specific edge release by commit SHA (tag `edge-<sha>`):**
```bash
curl -sSL https://github.com/ihelio/rulesify/releases/latest/download/install.sh | bash -s -- --edge abc1234
```

**Install specific version tag:**
```bash
curl -sSL https://github.com/ihelio/rulesify/releases/latest/download/install.sh | bash -s -- v0.3.0
```

**Show help:**
```bash
curl -sSL https://github.com/ihelio/rulesify/releases/latest/download/install.sh | bash -s -- --help
```

**Note:** Edge releases are tagged as `edge` (latest) and `edge-<sha>` (immutable). They are pre-release builds and may be unstable. Use stable releases for production.

### Manual Installation (Fallback)

1. Download the latest binary for your OS/arch from [GitHub Releases](https://github.com/ihelio/rulesify/releases).
2. Move it to `~/.local/bin` (create the directory if it doesn't exist):
   ```bash
   mkdir -p ~/.local/bin
   mv rulesify-<os>-<arch> ~/.local/bin/rulesify
   chmod +x ~/.local/bin/rulesify
   ```
3. Add `~/.local/bin` to your `PATH` if not already present.

## Quick Start

### Basic Usage
```bash
# Create a new rule
rulesify rule new typescript-style

# Import existing rules from different tools
rulesify import --tool cursor .cursor/rules/my-rule.mdc
rulesify import --tool cline .clinerules/coding-standards.md

# Validate rules for quality and compliance
rulesify validate --all
rulesify validate typescript-style

# Deploy to all configured tools
rulesify deploy --all

# Deploy to specific tool
rulesify deploy --tool cursor --all
rulesify deploy --tool cline --rule typescript-style

# Sync deployed rules back to URF (preview first)
rulesify sync --dry-run
rulesify sync
```

### Synchronization Examples

**Sync reads deployed tool files and updates URF files when changes are detected.**

```bash
# Synchronize all deployed rules back to URF format
rulesify sync

# Preview changes without applying them
rulesify sync --dry-run

# Sync a single rule only
rulesify sync --rule typescript-style --dry-run

# Sync from a specific tool only
rulesify sync --tool cursor
```

### Import Examples

Import rules from different AI tools:

```bash
# Import from Cursor (YAML frontmatter + Markdown)
rulesify import --tool cursor .cursor/rules/python-style.mdc

# Import from Cline (Simple Markdown)
rulesify import --tool cline .clinerules/react-patterns.md

# Import from Claude Code (Markdown in project root)
rulesify import --tool claude-code python-style.md

# Import from Goose (Plain text hints)
rulesify import --tool goose coding-standards.goosehints

# Import with custom rule ID
rulesify import --tool cursor .cursor/rules/my-rule.mdc --rule-id custom-name
```

### Validati

... (truncated)