AI Rules Converter

AI Rules Converter is a VS Code extension and standalone CLI tool designed to streamline the management of AI coding rules. It allows you to easily convert rule definitions between various AI-assisted IDE and CLI formats, ensuring your coding standards are consistent across all your tools.

Supported Formats

Features

• Full Agentic Migrations: Seamlessly migrate all capabilities — rules, skills (including symlinks), MCP servers, and event lifecycle hooks — between formats.
• Multi-Format Support: Convert rules and capabilities between all 8 supported formats.
• Automatic Detection: Automatically detects rules, skills, MCPs, and event hooks in your workspace.
• One-Click Conversion: Convert rules directly from the "Detected Rules" side panel.
• Bulk Conversion: Convert entire folders or all rules for a given format at once.
• Rule Management: Delete obsolete or incorrect rules directly from the extension view.
• Live Updates: The view automatically refreshes when changes are made.
• Standalone CLI: Use from the terminal without VS Code — great for CI/CD pipelines.

VS Code Extension Usage

1. Open the Rules Converter View: Click on the ruler icon in the Activity Bar to open the "Rules Converter" side panel.
2. View Detected Rules & Capabilities: The extension will scan your workspace and list all detected rules, skills, MCP servers, and event hooks, grouped by format.
3. Migrate Workspace Capabilities:
   • Click the Migrate Workspace icon (🔄) in the panel toolbar.
   • Select the source format to migrate FROM.
   • Select the target format to migrate TO.
   • All rules, skills, MCP configs, and hooks will be migrated/merged.
4. Convert a Rule:
   • Hover over a rule in the list.
   • Click the "Convert Rule" icon (or right-click and select "Convert Rule").
   • Select the target format from the quick pick list.
5. Convert All Rules in a folder/format:
   • Hover over an IDE group or subfolder.
   • Click the "Convert All Rules" (⇄) icon.
6. Delete a Rule:
   • Hover over a rule in the list.
   • Click the trash icon to remove it.

Standalone CLI Usage

The CLI is available via npx without any installation:

# List all detected rules in the current directory
npx ai-rules-converter scan

# List all detected agent capabilities (rules, skills, MCPs, hooks) in the workspace
npx ai-rules-converter scan-all

# Migrate all capabilities (rules, skills, MCP, hooks) from Antigravity to the new agy format
npx ai-rules-converter migrate --from antigravity --to agy

# Convert all Cursor rules to Claude Code format
npx ai-rules-converter convert --from cursor --to claude-code

# Convert rules in a specific project
npx ai-rules-converter convert --from antigravity --to gemini-cli --root ./my-project

# Preview migration without writing files
npx ai-rules-converter migrate --from cursor --to agy --dry-run

# List all supported formats
npx ai-rules-converter list-formats

CLI Options

Flat-File Format Notes (Claude Code & Gemini CLI)

Claude Code and Gemini CLI use a single flat Markdown file (CLAUDE.md / GEMINI.md) rather than one file per rule. The converter handles this automatically:

• Scanning: Splits the file by ## Heading sections — each becomes a separate rule in the tree view.
• Converting TO Claude Code/Gemini CLI: Rules are written as ## {rule name} sections, concatenated into the flat file.
• Converting multiple rules: The file is freshly written for the first rule, then subsequent rules are appended.

Known Issues

• Ensure your rule files are valid Markdown before converting.
• For Claude Code/Gemini CLI formats, very long rules may exceed token limits recommended by those tools (~500 tokens per file).

Release Notes

Enjoy using AI Rules Converter!