releaserun CLI
v1.0.0Scan your project for end-of-life dependencies, known CVEs, and version health issues. Get an A-F health grade for your entire stack in one command.
$ npx releaserun check
No install required. Runs with npx. Needs Node.js 18+.
What You Get
Point it at any project directory. It finds your dependency files, checks every technology against live EOL and CVE data, and gives you a grade.
releaserun v1.0.0 — Stack Health Check Scanning /Users/dev/myproject... Found 5 technologies ┌─────────────┬─────────┬────────┬──────┬───────┐ │ Technology │ Version │ EOL │ CVEs │ Grade │ ├─────────────┼─────────┼────────┼──────┼───────┤ │ Node.js │ 18.0 │ Apr 25 │ 0 │ F │ │ React │ 18.2 │ -- │ 0 │ A │ │ Python │ 3.9 │ Oct 25 │ 3 │ F │ │ Django │ 4.2 │ Apr 26 │ 0 │ D │ │ Express │ 4.18 │ -- │ 0 │ A │ └─────────────┴─────────┴────────┴──────┴───────┘ Overall Grade: F (2 of 5 technologies need attention) ! Node.js 18.0 has reached EOL. Upgrade recommended. ! Django 4.2 is approaching EOL. Plan an upgrade.
Install
Run without installing
$ npx releaserun check
Install globally
$ npm install -g releaserun
Commands
releaserun check
Scan a directory for dependency files and report health status for every detected technology.
$ releaserun check # scan current directory $ releaserun check --path ./my-app # scan a specific directory $ releaserun check --json # JSON output for scripting $ releaserun check --fail-on D # exit non-zero if anything grades D or worse $ releaserun check --verbose # show API calls and timing
releaserun badges
Auto-detect your stack and generate ReleaseRun badges for your README.
$ releaserun badges # health badges (default) $ releaserun badges --badge-type eol # EOL status badges $ releaserun badges --badge-type cve # CVE count badges
Markdown is copied to your clipboard automatically. Paste it straight into your README.
releaserun ci
CI-optimized output. No colors, no table formatting. Built for piping and parsing.
$ releaserun ci # plain text $ releaserun ci --json # JSON output $ releaserun ci --fail-on D # exit 1 if D, exit 2 if F
CI/CD Integration
Drop it into any pipeline. The --fail-on flag lets you set your own bar for what's acceptable.
# GitHub Actions - name: Check stack health run: npx releaserun check --fail-on D # GitLab CI stack-check: script: npx releaserun check --fail-on D # Pre-commit hook npx releaserun check --fail-on F
Exit codes: 0 = all good (B or above), 1 = something grades C or D, 2 = something grades F. Your pipeline, your threshold.
Supported Files
Detects technologies from 10+ file formats. 100+ package-to-technology mappings built in.
Grading System
Related Tools
Prefer a browser-based approach? Try these free tools:
FAQ
Does it require an API key?
What files does it detect?
Can I use it in CI/CD?
releaserun ci --fail-on D to exit non-zero when any dependency grades D or worse. Works with GitHub Actions, GitLab CI, Jenkins, CircleCI, and any other CI system that can run Node.js.What Node.js version do I need?
Is the data accurate?
Can I generate badges for my README?
releaserun badges and it'll auto-detect your stack, generate the markdown, and copy it to your clipboard. Supports health, EOL, version, and CVE badge types. You can also use the visual Badge Builder.Try it now
One command. No install. No signup.
$ npx releaserun check