Guide

Necro is a local, free CLI that finds dead code in TypeScript — and, unlike pure-static tools, refuses to guess where it can’t be sure. Each finding comes with a confidence tier and an evidence chain you can audit.

This guide walks from install to reading results to wiring Necro into CI.

Start here

• Introduction — what Necro finds and why.
• Installation — get it running (from source today).
• Quickstart — your first scan and how to read it.

Understanding what you see

• Confidence tiers — certain / likely / maybe.
• Evidence chains — the reasoning behind each verdict.
• The test-only verdict — prod-dead, kept warm by tests.
• Dead code & reachability — how Necro decides.

Configure and integrate

• Configuration — necro.config.json.
• Framework awareness — jest / vitest.
• CI integration — JSON output for pipelines.
• Roadmap — what’s planned next.