Directory-based AI governance for development teams.

Documentation: goldziher.github.io/ai-rulez

ai-rulez organizes your AI assistant rules, context, and domain-specific guidance in a single .ai-rulez/ directory. Write once, generate native configurations for Claude, Cursor, Windsurf, Copilot, Gemini, and more.

Key features:

• Directory-based – One .ai-rulez/ directory for all your AI tooling
• Multi-tool generation – Generate configs for all major AI assistants from one source
• Domain separation – Organize rules by backend, frontend, QA, or any domain
• Profiles – Define profiles for different teams or use cases
• Includes – Compose from local packages or Git repositories
• CRUD operations – Manage configuration programmatically via CLI or MCP

npm:

npx ai-rulez@latest init "My Project"

uv:

uvx ai-rulez init "My Project"

Homebrew (macOS/Linux):

brew install goldziher/tap/ai-rulez

Go:

go install github.com/Goldziher/ai-rulez/cmd@latest

npm (Node.js):

npm install -g ai-rulez

uv (Python):

uv tool install ai-rulez

pip (Python):

pip install ai-rulez

# Initialize a new project
ai-rulez init "My Project" --preset claude

# Add a rule
ai-rulez add rule coding-standards --priority high

# Generate configs for all tools
ai-rulez generate

This creates CLAUDE.md, .cursorrules, and other native configs from your .ai-rulez/ directory.

Full Documentation →

We welcome contributions! Read CONTRIBUTING.md for development setup and guidelines.