Strata

Strata records code metrics from Git commits (cognitive erosion, cyclomatic erosion, function complexity, verbosity) and displays them in a live dashboard. It uses scb-check to measure Python, Rust, and JavaScript source.

Named for geological layers, Strata shows how a codebase builds up and changes over time. Browse directories and files, follow changes across commits, and open any measurement's source at that commit, with syntax highlighting and metric hotspots.

Strata measuring its own source across ten commits.

The source window shades function ranges by the selected metric. The minimap shows hotspots across the file and lets you jump to them.

Setup

Requires Git and Python 3.12+. Install the strata command with uv or pip:

uv tool install git-strata
# or
pip install git-strata

In a project with source under src, install the commit hook and record the current commit:

strata hook install --source-root src
strata scan

Every recording scans Python, JavaScript, and Rust under the source roots, with separate metrics per language. State lives in .strata/, excluded from Git.

Start the live dashboard:

strata serve

Open http://127.0.0.1:8766/. Use --port to serve several projects at once. Scores flag code worth reading, not quality or correctness.

Commands act on the current repository; pass --repo for another. See commit recording and dashboard usage for details.

After uv tool upgrade git-strata, restart running servers.

Agent skill

skills/strata teaches coding agents to run Strata and turn its measurements into review suggestions. For Claude Code, link it into your skills directory:

ln -s "$PWD/skills/strata" ~/.claude/skills/strata

Development

uv run pytest -q tests
node --test tests/dashboard.test.cjs
uv run ruff check src tests

Browser checks require Chromium and WebKit installed through Playwright:

uv run --with playwright playwright install chromium webkit
uv run --with playwright python tests/source_browser.py
uv run --with playwright python tests/multilanguage_browser.py

Credits

scb-check, by Gabriel Orlanski, provides Strata's metric analysis. Strata pins version 0.2.0 and adds commit recording and visualization around its results.

SlopCodeBench, from SprocketLab, and the SlopCodeBench paper provide the research and metric definitions behind this project.

License

Strata is licensed under the MIT License. Bundled third-party assets retain their own licenses in the vendor directory.