Forensic Repository Archaeology

Your git history
has a story to tell

Mine commits. Detect development signals. Map eras. Run six analysis vectors. Generate forensic visualizations — from your terminal, CI pipeline, or AI assistant.

Install now See what it does
terminal
$ pip install devarch-framework
$ devarch init my-project
$ devarch mine ./repo -p my-project
$ devarch analyze my-project
$ devarch visualize my-project
archaeology.html written
Capabilities

Six analysis vectors.
One forensic picture.

Signal Detection

Find the moments that mattered

Velocity shifts, activity gaps, burst patterns, team rhythm changes. Every signal is a timestamp on something that happened in your project.

devarch signals my-project --min-gap-days 7
Era Mapping

Map development phases

Detect era boundaries and label development phases — greenfield, growth, maturity, maintenance — automatically.

6 Vectors

Structured analysis, zero configuration

SDLC Gap Finder ML Pattern Mapper Agentic Workflow Formal Terms Source Archaeologist YouTube Correlator
Visualizations

Three themes. No config.

Warm, Editorial, and Modern HTML dashboards with Chart.js and D3.js. Responsive, accessible, ready to share.

MCP Server

Run it from your AI assistant

14 MCP tools for Claude Code, Cursor, and any AI coding environment. Archaeology without leaving your editor.

Pipeline

Six commands from git log
to archaeology report

Step 1

Mine

Extract git commit history with stats

Step 2

Build DB

SQLite database for fast queries

Step 3

Signals

Detect patterns and anomalies

Step 4

Analyze

Run 6 analysis vectors

Step 5

Visualize

HTML dashboard with charts

Step 6

Report

Full forensic archaeology report

Or run the full pipeline in one command:

devarch run-pipeline ./my-repo -p my-project
Three ways to run

CLI. MCP server.
GitHub Action.

CLI

20+ commands, any terminal

Install via pip. Run from your terminal. The full pipeline — mine, analyze, visualize, report — with tab completion and help text for every command.

pip install devarch-framework
devarch run-pipeline ./repo -p my-project
MCP Server

AI assistant integration

14 tools for Claude Code, Cursor, and any MCP-compatible editor. Run archaeology without leaving your AI coding environment.

pip install devarch-framework[mcp]
devarch-mcp
GitHub Action

Zero-config CI integration

Add one workflow file. Get weekly archaeology reports as downloadable artifacts. Full git history required — set fetch-depth: 0.

name: Archaeology Report
on:
  schedule:
    - cron: '0 0 * * 0'
  workflow_dispatch:
  steps:
    - uses: actions/checkout@v4
      with:
        fetch-depth: 0

Run it on your repo tonight

MIT licensed. Free. Open source. Built for developers who want to understand how their codebase evolved.

View on GitHub PyPI