Stack Health Check

Analyze your dependency health on every pull request. Get a 0-100 score covering freshness, compatibility, and modernity — powered by IndieStack.

Quick Start

Add to .github/workflows/stack-health.yml:

name: Stack Health Check
on:
  pull_request:
    paths:
      - 'package.json'
      - 'requirements.txt'

permissions:
  pull-requests: write

jobs:
  health-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: indiestack/stack-health-check@v1

That's it. Every PR that changes dependencies gets a health score comment.

What it checks

Metric	Weight	What it measures
Freshness	30%	Are your dependencies actively maintained?
Cohesion	40%	Do your dependencies work well together?
Modernity	30%	Are there better-maintained alternatives?

Example PR comment

🟢 Stack Health: 92/100 — Healthy

Freshness 95 · Cohesion 88 · Modernity 93 · 12/12 deps analyzed

View full report · Powered by IndieStack

Options

Input	Default	Description
manifest-path	Auto-detected	Path to package.json or requirements.txt
api-key	None	IndieStack API key for detailed reports
fail-below	0 (disabled)	Fail the check if score drops below this

Fail on low scores

- uses: indiestack/stack-health-check@v1
  with:
    fail-below: 70

Custom manifest path

- uses: indiestack/stack-health-check@v1
  with:
    manifest-path: 'apps/web/package.json'

Detailed reports (Pro)

- uses: indiestack/stack-health-check@v1
  with:
    api-key: ${{ secrets.INDIESTACK_KEY }}

How it works

1. Detects package.json or requirements.txt in your repo
2. Sends the manifest to IndieStack's analysis API
3. Posts a single-line score comment on your PR
4. Links to a full shareable report

No signup required. No API key needed. Works out of the box.

Data & Privacy

• Only your dependency names and versions are sent (not source code)
• Analysis data improves recommendations for all users (anonymized)
• No data is sold or shared with third parties

Fix your score with AI

Install the IndieStack MCP server in your IDE to let your AI agent fix dependency issues automatically:

claude mcp add indiestack -- uvx --from indiestack indiestack-mcp

Your agent will check dependency health before installing packages and suggest alternatives for problematic dependencies.

Links

• IndieStack — 6,500+ developer tools
• Stack Health Check — Web version
• MCP Server — For AI coding agents