Metadata-Version: 2.4
Name: ai-rulez
Version: 5.12.1
Summary: Author, generate, validate and govern rules, skills, plugins and MCP configuration for 52 AI coding assistants from one .ai-rulez/ source. Lock, sign and SBOM your agent configuration, review it with verified model evidence, and publish plugin bundles. CLI, MCP server and Go API.
Home-page: https://github.com/Goldziher/ai-rulez
Author: Na'aman Hirschfeld
Author-email: nhirschfeld@gmail.com
License-Expression: MIT AND Apache-2.0 AND Unicode-3.0
Project-URL: Homepage, https://goldziher.github.io/ai-rulez/
Project-URL: Documentation, https://goldziher.github.io/ai-rulez/
Project-URL: Bug Reports, https://github.com/Goldziher/ai-rulez/issues
Project-URL: Source, https://github.com/Goldziher/ai-rulez
Project-URL: Changelog, https://github.com/Goldziher/ai-rulez/blob/main/CHANGELOG.md
Project-URL: Funding, https://github.com/sponsors/Goldziher
Keywords: ai-rules,agents-md,agent-skills,agent-plugins,claude-code,cursor,codex,copilot,mcp,ai-governance,sbom,sigstore,supply-chain,llms-txt,cli
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Security
Classifier: Topic :: System :: Software Distribution
Classifier: Topic :: Software Development :: Pre-processors
Classifier: Topic :: Text Processing :: General
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Go
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: Console
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: THIRD_PARTY_NOTICES.md
License-File: LICENSES/Apache-2.0.txt
License-File: LICENSES/MIT-npm-high-impact.txt
License-File: LICENSES/Unicode-3.0.txt
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: license-expression
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

<p align="center">
  <img src="https://raw.githubusercontent.com/Goldziher/ai-rulez/main/docs/assets/ai-rulez-banner.png" alt="AI-Rulez" width="820" />
</p>

# ai-rulez

[![PyPI version](https://img.shields.io/pypi/v/ai-rulez?color=blue)](https://pypi.org/project/ai-rulez/)
[![License](https://img.shields.io/github/license/Goldziher/ai-rulez?color=blue)](https://github.com/Goldziher/ai-rulez/blob/main/LICENSE)

One source for the rules, skills and settings of every AI coding assistant. ai-rulez keeps them in a single `.ai-rulez/` directory and generates the native files of 52 tools (`AGENTS.md`, `CLAUDE.md`, `.cursor/rules/`, skills, MCP and settings files), then validates, locks, signs and publishes them.

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

## Install

Requires Python 3.11 or newer.

```bash
pipx install ai-rulez     # or: uv tool install ai-rulez, pip install ai-rulez
```

Or run it without installing:

```bash
uvx ai-rulez init acme
```

The package is a thin launcher for the `ai-rulez` Go binary and installs the `ai-rulez` command. On the first run it
downloads the binary for your platform (Linux and macOS on amd64 and arm64, Windows on amd64) from the GitHub release
that matches the package version, verifies its SHA-256 checksum and caches it in `~/.cache/ai-rulez`. It is
re-downloaded when the package version changes.

## Quickstart

```bash
ai-rulez init acme
ai-rulez add rule testing --content '# Testing

- Every bug fix ships with a regression test.'
ai-rulez generate
```

Set the tools you use in `.ai-rulez/config.toml` with `presets = ["claude", "cursor", "codex"]`. Run
`ai-rulez generate --check` in CI to catch drift. The
[Quick start](https://goldziher.github.io/ai-rulez/quick-start/) covers the rest.

## Other channels

Homebrew (`brew install goldziher/tap/ai-rulez`), npm (`npm install -g ai-rulez`) and Go
(`go install github.com/Goldziher/ai-rulez/v5/cmd/ai-rulez@latest`). See
[Installation](https://goldziher.github.io/ai-rulez/installation/).

## Links

[Documentation](https://goldziher.github.io/ai-rulez/) · [Source](https://github.com/Goldziher/ai-rulez) ·
[Issues](https://github.com/Goldziher/ai-rulez/issues) · [MIT license](https://github.com/Goldziher/ai-rulez/blob/main/LICENSE)
