repo-archaeologist 0.1.0

A CLI tool that scans git repositories to find dead code, stale files, unused dependencies, and abandoned branches.

Repo Archaeologist

A CLI tool that scans git repositories to find dead code, stale files, unused dependencies, and abandoned branches.

Installation

pip install repo-archaeologist

Usage

# Scan a repository
repo-archaeologist scan /path/to/repo

# Generate a markdown report
repo-archaeologist scan /path/to/repo --format markdown --output report.md

# Scan only Python files
repo-archaeologist scan /path/to/repo --language python

# Show only high-risk findings
repo-archaeologist scan /path/to/repo --min-score 70

# Analyze abandoned branches only
repo-archaeologist branches /path/to/repo

# Analyze unused dependencies only
repo-archaeologist deps /path/to/repo

Features

• Dead Symbol Detection: Find functions and classes that are never referenced
• Stale File Detection: Identify files untouched for months or years
• Unused Dependency Detection: Find packages declared but never imported
• Abandoned Branch Detection: Locate old, unmerged branches
• Ownership Risk Analysis: Identify files owned by a single contributor
• Decay Scoring: Rank findings by risk level (0-100)

Supported Languages

• Python
• JavaScript/TypeScript

License

MIT