ai-rulez

Write AI assistant rules once. Generate configs for 18 different tools.

Every AI coding tool wants its own config format. Claude needs CLAUDE.md, Cursor wants .cursor/rules/, Copilot expects .github/copilot-instructions.md. Keeping them in sync is tedious and error-prone.

ai-rulez solves this: define rules and context in .ai-rulez/, run generate, and get native configs for all your tools.

npx ai-rulez@latest init && npx ai-rulez@latest generate

[Documentation](https://goldziher.github.io/ai-rulez/)

• 18 preset generators: Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Continue.dev, Amp, Junie, Codex, OpenCode, and custom presets
• Commands system: Define slash commands once, use them across tools that support it
• Context compression: 34% size reduction with smart whitespace optimization
• Remote includes: Pull shared rules from git repos (company standards, team configs)
• Profile system: Generate different configs for backend/frontend/QA teams
• MCP server: Let AI assistants manage their own rules via Model Context Protocol
• Type-safe schemas: JSON Schema validation for all config files

# No install required
npx ai-rulez@latest init "My Project"
npx ai-rulez@latest generate

This creates:

.ai-rulez/
├── config.yaml       # Which tools to generate for
├── rules/            # Guidelines AI must follow
├── context/          # Project background info
├── skills/           # Specialized AI roles
├── agents/           # Agent-specific prompts
└── commands/         # Slash commands

And generates native configs for each tool you specify.

# .ai-rulez/config.yaml
version: "3.0"
name: "My Project"

presets:
  - claude
  - cursor
  - copilot
  - windsurf

# Optional: team-specific profiles
profiles:
  backend: [backend, database]
  frontend: [frontend, ui]

# Optional: share rules across repos
includes:
  - name: company