kospex

Kospex maps the knowledge, technology and maintenance risk hiding in your git repositories.

It answers questions that are surprisingly hard to answer at scale:

• Who still knows this code?
• What are we actually built on?
• What’s quietly going stale?

Kospex inspects cloned repositories on disk and aggregates everything into a single queryable database, so you can ask those questions across one repo or thousands. There are two ways to use it: a CLI for scanning, querying and automation, and a Web UI (kweb) for exploring the data interactively.

Inspired by the excellent Mergestat lite, whose database structure we use to model data from git repositories.

Quickstart

Requires Python 3.12+. A virtual environment is optional but strongly recommended.

# 1. Install
pip install kospex

# 2. Set up ~/kospex (config, database, logs) and ~/code (cloned repos)
kospex init --create --verbose

# 3. Clone a repo — this clones into ~/code/GIT_SERVER/ORG/REPO and syncs it
kgit clone https://github.com/mergestat/mergestat-lite

# 4. Ask some questions
kospex summary
kospex developers -days 90…