Harbinger

Track End-of-Life dates for your tech stack

Never get caught off-guard by unsupported dependencies. Harbinger scans your Ruby and Rails projects and warns you before support ends.

$ gem install stackharbinger
View on GitHub →

Features

🔍

Auto-Detection

Automatically detects Ruby and Rails versions from .ruby-version, Gemfile, and Gemfile.lock

📅

EOL Data

Fetches official EOL dates from endoflife.date with smart 24-hour caching

🎨

Color-Coded

Visual warnings: red for EOL, yellow for <6 months, green for safe

⚡

Zero Config

Just run harbinger scan - no setup or configuration required

💾

Works Offline

Smart caching means it works offline after initial data fetch

📊

Dashboard View

Track multiple projects and see EOL status at a glance with harbinger show

🔄

Bulk Scanning

Recursively scan entire directories to find and track all your projects

🧪

Well Tested

52 RSpec tests with 100% pass rate, built with TDD

Quick Start

# Install
$ gem install stackharbinger
# Scan your project
$ harbinger scan
# Output:
Detected versions:
Ruby: 3.2.0
Rails: 7.0.8
Ruby 3.2.0:
EOL Date: 2026-03-31
Status: 437 days remaining
Rails 7.0.8:
EOL Date: 2025-06-01
Status: ALREADY EOL

Commands

  • harbinger scan --path [PATH] - Scan a project and show EOL status
  • harbinger scan --save - Save project for tracking
  • harbinger scan --recursive - Scan all projects in a directory
  • harbinger show - View dashboard of all tracked projects
  • harbinger update - Force refresh EOL data from API
  • harbinger version - Show harbinger version

Roadmap

✅ V0.2.0 (Current)

  • • Dashboard view
  • • Project tracking
  • • Recursive scanning
  • • Config management

📋 V0.3.0 (Planned)

  • • PostgreSQL detection
  • • MySQL detection
  • • Rescan command
  • • Export to JSON/CSV

🚀 V1.0 (Future)

  • • Python support
  • • Node.js support
  • • Go & Rust support
  • • Homebrew distribution
GitHub RubyGems Documentation

Built with ❤️ using Ruby and Thor | EOL data from endoflife.date