codemortem

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

Installation

``bash
npm install -g codemortem
`

Or run without installation:
`bash
npx codemortem
`

Usage

`bash


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