Metadata-Version: 2.4
Name: ai-rulez
Version: 5.13.4
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.
Author: Na'aman Hirschfeld
Author-email: nhirschfeld@gmail.com
License-Expression: MIT AND Apache-2.0 AND Unicode-3.0
Keywords: ai-rules,agents-md,agent-skills,agent-plugins,claude-code,cursor,codex,copilot,mcp,ai-governance,sbom,sigstore,supply-chain,llms-txt,cli
Requires-Python: >=3.11
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
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
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

<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 installs the `ai-rulez` command. Platform wheels (Linux and macOS on amd64 and arm64, Windows on amd64)
carry the `ai-rulez` Go binary, so installing needs no access beyond PyPI. Where no wheel matches, pip installs the
source distribution and the launcher downloads the binary from the GitHub release that matches the package version on
the first run, verifies its SHA-256 checksum and caches it in `~/.cache/ai-rulez`. Linux binaries need glibc; Alpine
(musl) is not supported.

## 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)
