ai-rulez
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
Install
Requires Python 3.11 or newer.
pipx install ai-rulez # or: uv tool install ai-rulez, pip install ai-rulez
Or run it without installing:
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
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 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.
Links
Documentation · Source · Issues · MIT license
Metadata
Release files for ai-rulez 5.11.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ai_rulez-5.11.1.tar.gz | 16.2 kB | With provenance | Details for ai_rulez-5.11.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ai_rulez-5.11.1-py3-none-any.whl | Python 3 | none | any | Details for ai_rulez-5.11.1-py3-none-any.whl |
Total release size: 33.5 kB
Release files / ai_rulez-5.11.1.tar.gz
| Download URL | ai_rulez-5.11.1.tar.gz |
|---|---|
| Size | 16.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
716d96a302aa7e0776d34eb1abd0ad8c44c96a72c2503dc496f67a9e96355c8c
|
|
BLAKE2b-256 checksum How to use checksums |
59e32d4e422a6ffd9e1585dca42c1740a55f5eb050408c347554f2e1e01c5512
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logRelease files / ai_rulez-5.11.1-py3-none-any.whl
| Download URL | ai_rulez-5.11.1-py3-none-any.whl |
|---|---|
| Size | 17.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
15f3771c2479266011afa5261613d6d9181bf7cb1a5d9c1a913f56aaba5dc73f
|
|
BLAKE2b-256 checksum How to use checksums |
8843e7e2c9a72a6314a999c7a906e11eb159219b78ef6aa66f179fd800412c4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logSecurity for ai-rulez 5.11.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for ai_rulez-5.11.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.