Metadata-Version: 2.4
Name: readystack-ai-model-retirement-lint
Version: 0.1.8
Summary: Finds the LLM model IDs pinned in your code that vendors have already switched off, or have dated to switch off, with the replacement and the date. (bundled Node.js runtime)
Author-email: ReadyStack <support@getreadystack.com>
License: Proprietary - see LICENSE.txt
Project-URL: Homepage, https://getreadystack.com/tools/ai-model-retirement-lint?ref=pypi
Project-URL: Documentation, https://getreadystack.com/tools/ai-model-retirement-lint?ref=pypi
Project-URL: Support, https://getreadystack.com/support
Keywords: llm,openai,anthropic,gemini,deprecation
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: nodejs-wheel-binaries>=20
Dynamic: license-file

# AI Model Retirement Lint

> Runs the same checker as the npm package `@readystack/ai-model-retirement-lint` on a Node.js runtime that pip installs for you (`nodejs-wheel-binaries`) - no system Node.js needed. Your files are checked locally.

![OpenAI Model Deprecation Lint - retired model IDs in code — finds the line](https://getreadystack.com/img/promo/ai-model-retirement-lint_demo.gif)

Finds the LLM model IDs pinned in your code that vendors have already switched off, or have dated to switch off, with the replacement and the date.

## Install

```
ai-model-retirement-lint file
```

Node 18+. The same 33 rules as the VS Code extension, from a terminal or CI.

## Free

- Checks the file you have open against all 33 rules and names every retired or expiring model ID, its date and the vendor's replacement - no key, no limit, no watermark.
- `--rules` lists every rule

## With a licence ($29 once)

- Scans every file in the repository, emits CI output that fails the build before a dead model ID can merge, and applies the vendor's replacement in place.

```
@readystack/ai-model-retirement-lint --dir ./templates --report html --out report.html
```

OpenAI removes 12 model IDs from the API in one sweep on 2026-10-23; Anthropic gives 60 days notice before a retirement.

## Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

```json
{ "mcpServers": { "ai-model-retirement-lint": { "command": "npx", "args": ["-y", "@readystack/ai-model-retirement-lint", "--mcp"] } } }
```

Tools: `check_text` and `check_file` (free) · `check_dir` (licence). The agent gets every finding with the line number.

## Use in CI

```yaml
- name: AI Model Retirement Lint
  run: npx -y @readystack/ai-model-retirement-lint --dir . --ci
```

(container: `docker run --rm -v "$PWD:/work" getreadystack/ai-model-retirement-lint --dir /work --ci`)

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.

[Get a licence](https://getreadystack.com/api/buy/cl/polar_cl_EOiE7ckv1WZujsc6UOfnGhc0lxBYyaPS8uZLl2Fo9Ap)


<!-- ai model retirement lint -->


## Install (PyPI)

```
pip install readystack-ai-model-retirement-lint
ai-model-retirement-lint --help
```
