codemortem

Local project autopsy CLI that scans codebases and generates rich, readable reports with scores, grades, and actionable insights.

Installation

npm install -g codemortem

Or run without installation:

npx codemortem

Usage

# Analyze current directory
codemortem
codemortem analyze

# Analyze specific directory
codemortem --dir /path/to/project
codemortem analyze --dir /path/to/project

# Show summary only
codemortem --summary
codemortem --s

# Output in JSON format
codemortem --json

# Run deep analysis
codemortem --deep

Features

• 🔍 Static Analysis: Scans all source files recursively
• 📊 Rich Metrics: Code Quality, Architecture, Documentation, Dependencies, Security, Testing, Git
• 🎯 Actionable Insights: Identifies specific pain points with file and line numbers
• 📈 Visual Reports: Colorful ASCII bar charts for quick comprehension
• 🏷️ Letter Grades: Overall score with A-F grading system
• 🚨 Risk Assessment: High, medium, and low severity issue identification

Example Output

.codemortem - Project Autopsy Report.
Starting analysis...

🔍 codemortem - Project Autopsy Report
=====================================

Overall Score: 87/100 (B Grade)

Category Breakdown:
Code Quality       ███████████████████░ 96
Architecture       ████████████████████ 100
Documentation      ██████████████░░░░░░ 70
Dependencies       ████████████████░░░░ 80
Security           ██████████████████░░ 90
Testing            ████░░░░░░░░░░░░░░░░ 20
Git Process        ███████████████████░ 98

Testing Maturity:
Test-to-Source Ratio ░░░░░░░░░░░░░░░░░░░░ 0

Risk Profile:
High Risk Issues   ████████████████░░░░ 80
Medium Risk Issues ██████████████████░░ 90
Security Issues    ███████████████████░ 95

⚠️  Top Pain Points:
  1. index.js:17 - Function too long (67 lines, threshold: 50)
  2. project - No test files detected
  3. analyzers/git-analyzer.js:1 - High nesting depth detected (6, threshold: 4)
  4. analyzers/code-quality-analyzer.js:1 - High nesting depth detected (5, threshold: 4)
  5. project root - README file not found

📊 Project Statistics:
  • Files analyzed: 11
  • Total lines: 1,588
  • Languages: js
  • Avg file size: 4,313 bytes

🚨 Risk Summary:
  • Critical: 2 high severity issues
  • High: 5 medium severity issues

✅ Strengths:
  • Good security practices
  • Clean, well-structured code

Analysis complete!

Metrics & Scoring

The tool analyzes 7 key areas:

• Code Quality: File length, function length, nesting depth, cyclomatic complexity
• Architecture: God files, folder depth, coupling, cohesion
• Documentation: README completeness, comment density, JSDoc coverage
• Dependencies: Package.json completeness, unused dependencies, deprecated packages
• Security: Hardcoded secrets, unsafe APIs, vulnerable dependencies
• Testing: Test file detection, test-to-source ratio, coverage estimation
• Git Process: Commit history quality, branch strategy, commit message quality

Options

| Flag | Alias | Description | |------|-------|-------------| | --dir | -D | Directory to analyze (defaults to current) | | --summary | -s | Show summary report only | | --json | -j | Output in JSON format | | --deep | -d | Run deep analysis |

License

MIT