airulefy 0.1.2

Unify your AI rules across multiple AI coding agents

Airulefy (in development)

Unify your AI rules. One source of truth, synced across all major AI coding agents.

Airulefy makes it easy to maintain a single set of rules in .ai/ and automatically generate or link them to each tool-specific format (Cursor, Copilot, Cline, Devin, etc.).
No more copy-pasting. No more inconsistent behavior.

---

✨ Features

• Unified .ai/ folder for all your project-wide AI rules (Markdown)
• Auto-generate:
  • .cursor/rules/*.mdc
  • .cline-rules
  • .github/copilot-instructions.md
  • devin-guidelines.md
• Symlink or copy mode (auto-detects OS capability)
• Optional YAML config: .ai-rules.yml
• Works with CI and pre-commit hooks

---

⚡ Quickstart

pip install airulefy

# Generate rules for all supported tools
airulefy generate

# Watch for changes in .ai/ and auto-regenerate
airulefy watch

🔧 Configuration

Create a .ai-rules.yml file in your project root to customize Airulefy's behavior:

default_mode: symlink  # or "copy"
tools:
  cursor:
    output: ".cursor/rules/core.mdc"  # custom output path
  cline:
    mode: copy  # override default mode
  copilot: {}  # use defaults
  devin:
    output: "devin-guidelines.md"

🧩 DevContainer Usage

Airulefy works seamlessly with GitHub Codespaces and VS Code DevContainers:

# Open in Codespace
gh codespace create -r airulefy/Airulefy

# Or clone and open locally with VS Code
git clone https://github.com/your-username/your-project.git
cd your-project
code .

🚀 CLI Commands

# Generate rules (default: symlink if supported)
airulefy generate

# Force copy instead of symlink
airulefy generate --copy

# Watch for changes and auto-regenerate
airulefy watch

# Validate configuration and files
airulefy validate

# List supported tools and their status
airulefy list-tools

# Show version
airulefy --version

🧠 Philosophy

Airulefy follows the "single source of truth" principle. Keep all your AI coding assistant rules in one place (.ai/ directory) and let Airulefy handle the synchronization to each tool's specific format.

This ensures:

1. Consistency across all AI assistants
2. Version control for your AI instructions
3. Simplicity in maintaining rules

📄 License

MIT © 2025 Kuu