An instrument for measuring how dead your GitHub repositories are.
Every GitHub account accumulates corpses: abandoned side-projects, forgotten forks, and code left to freeze in the dark. The Necrometer examines your commit history, push recency, archived status, and stranded stars to weigh your soul on a scale from vital to fully necrotic:
| Index | Status | Diagnosis |
|---|---|---|
| 0% – 14% | 🟢 Hale & Active | The Maintainer — recent commits, fresh life, corpses cleanly buried. |
| 15% – 49% | 🟡 Cooling | Cemetery Groundskeeper — signs of life remain, but winter approaches. |
| 50% – 79% | 🟠 Cold & Morbid | Crypt Keeper — the graveyard outnumbers the living; stars stranded. |
| 80% – 100% | 🔴 Necrotic | Mausoleum — no heartbeat detected; total digital decay. |
| Repository | Purpose |
|---|---|
necrometer |
The Core Engine. High-performance Rust CLI, SVG gauge card renderer with embedded Creepster typography, and WebAssembly compilation target. |
necrometer.dev |
The Web Instrument. Static haunted CRT web application hosted on GitHub Pages. Zero servers, client-side WASM necromancy, 1-click 𝕏 sharing, and high-res card exporter. |
necrometer-action |
The GitHub Action. Automated composite action that summons the pinned release binary, verifies SHA-256 checksums, and carves an updated SVG into your repo daily. |
Create .github/workflows/necrometer.yml in your profile repository (e.g. <username>/<username>) or project repo:
name: necrometer
on:
schedule: [{cron: "17 6 * * *"}] # daily
workflow_dispatch: # manual "run now"
permissions: { contents: write }
jobs:
necrometer:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
- uses: necrometer-dev/necrometer-action@v1
with:
token: ${{ secrets.NECRO_TOKEN || secrets.GITHUB_TOKEN }}Add the badge just beneath your profile or repository title:
[](https://necrometer.dev/?u=YOUR_USERNAME)Run the workflow once from your Actions tab. The Necrometer will carve necrometer.svg and keep it refreshed daily.
Conjured with 🖤 by necrometer.dev — no servers were harmed. They were already dead.