Project Analyzer

Deep analysis of project codebases for documentation and portfolio generation.

Capabilities

Code Statistics

• Lines of code by language
• File count and distribution
• Comment density
• Code complexity metrics

Dependency Analysis

• Direct dependencies
• Dev dependencies
• Outdated packages
• Security vulnerabilities

Git Analytics

• Total commits
• Contributors
• Activity timeline
• Commit frequency patterns

Architecture Detection

• Framework identification
• Design patterns used
• Module structure
• API surface

Usage

# Analyze current project
/analyze

# Analyze specific project
/analyze --project ~/projects/my-app

# Generate full report
/analyze --full --output report.md

Output Format

project:
  name: my-project
  path: /path/to/project
  created: 2025-10-15
  last_activity: 2026-01-19
  
code:
  total_lines: 45230
  languages:
    Python: 28450
    TypeScript: 12340
    YAML: 2100
    Markdown: 2340
  files: 234
  
git:
  total_commits: 847
  contributors: 3
  first_commit: 2025-10-15
  last_commit: 2026-01-19
  commit_frequency: 12/week
  
stack:
  frameworks: [FastAPI, Next.js, LangChain]
  databases: [PostgreSQL, Qdrant]
  infrastructure: [Docker, Vercel]
  
health:
  test_coverage: 78%
  doc_coverage: 65%
  dependency_freshness: 89%

Integration

Feeds into:

• knowledge-forge for Obsidian notes
• portfolio-forge for static site generation

Requirements

Install analysis tools:

# Code statistics (choose one)
brew install tokei  # Fast, Rust-based
brew install cloc   # Comprehensive, Perl-based

# For tree visualization
brew install tree