@endoflife-ai/eol-check
v1.0.1
Published
Check your runtimes against endoflife.ai — instantly from the terminal
Maintainers
Readme
eol-check
Check your runtimes against endoflife.ai — instantly from the terminal.
npx eol-checkScans your project for version pins and tells you which runtimes are end-of-life, approaching EOL, or still supported. Powered by endoflife.ai.
Usage
# Scan current directory (auto-detects version files)
npx eol-check
# Scan a specific directory
npx eol-check scan ./my-project
# Check a specific product and version
npx eol-check check nodejs 18
npx eol-check check python 3.11
npx eol-check check php 8.1
# List all 455+ tracked products
npx eol-check listExample output
endoflife.ai — scanning /my-project
Found 3 runtime(s) — checking against endoflife.ai...
✗ EOL nodejs 18 · EOL 2025-04-30 · 383 days past EOL [.nvmrc]
→ https://endoflife.ai/score/nodejs/18
⚠ Warning python 3.11 · EOL 2026-10-31 · 150 days remaining [.python-version]
→ https://endoflife.ai/score/python/3.11
✓ Supported go 1.24 · EOL 2027-02-01 [go.mod]
✗ 1 EOL runtime detected. Upgrade or add extended support.
Learn more: https://endoflife.aiDetects versions from
| File | Runtime |
|---|---|
| .nvmrc / .node-version | Node.js |
| .python-version | Python |
| .ruby-version / Gemfile | Ruby |
| .tool-versions (asdf) | Node.js, Python, Ruby, Go |
| package.json engines | Node.js |
| go.mod | Go |
| Dockerfile FROM | Node.js, Python, PHP, Ruby |
| composer.json | PHP |
| .terraform-version | Terraform |
Exit codes
| Code | Meaning |
|---|---|
| 0 | All runtimes supported |
| 1 | One or more EOL runtimes detected |
Use in shell scripts:
npx eol-check || echo "EOL runtimes found — upgrade before deploying"API key
The free tier allows 100 requests/day. For higher limits, set your endoflife.ai Pro API key:
EOL_API_KEY=your_key npx eol-checkCI integration
For CI pipelines, use the GitHub Action instead — it integrates directly with GitHub's build system and posts PR annotations.
Data
EOL dates and risk scores sourced from endoflife.ai — free lifecycle intelligence for 455+ products, updated daily.
License
MIT — endoflife.ai
