ai-checkkit — AI-era Python lint bundle

Catch the silent footguns AI leaves behind: no-op stubs that ship as None, asserts that vanish under -O, builtin shadowing, mutable defaults.

Bundles 4 focused linters that previously shipped as stubcheck, assertcheck, shadowcheck, mutablecheck — now one pip install.

Why ai-checkkit?

All 4 are zero-dependency, pure-ast, <0.1s on 10k lines.

Install

Requires Python 3.9+.

pip install ai-checkkit

# or editable for dev
pip install -e .[dev]

Backward compat aliases still work: stubcheck, assertcheck, shadowcheck, mutablecheck point to the same bundle.

Quick start

# Run all 4 checks (default)
ai-checkkit
ai-checkkit all ./src --check --json

# Individual linters (same flags as standalone)
ai-checkkit stubcheck ./src --min-severity medium --include-test
ai-checkkit assertcheck ./src --min-severity high
ai-checkkit shadowcheck ./src --allow id,type
ai-checkkit mutablecheck ./src --allow __init__

# Legacy aliases
stubcheck ./src --check
assertcheck --json ./src

Python API

from ai_checkkit.stubcheck import detect as stub_detect
from ai_checkkit.assertcheck import detect as assert_detect
from ai_checkkit.shadowcheck import detect as shadow_detect
from ai_checkkit.mutablecheck import detect as mutable_detect

findings = stub_detect(open("app.py").read(), "app.py")

Comparison vs separate installs

Development

pip install -e .[dev]
pytest -q --cov=ai_checkkit

License

MIT — see LICENSE.

Links

• Homepage: https://github.com/Rituparno-Majumdar/ai-checkkit
• Issues: https://github.com/Rituparno-Majumdar/ai-checkkit/issues
• Changelog: https://github.com/Rituparno-Majumdar/ai-checkkit/blob/main/CHANGELOG.md