Provenlens — Development skill for Claude Code

provenlens

A personal code knowledge graph for **Java, Ruby, TypeScript and JavaScript** — plus a **string-binding** layer that connects the places a call graph structurally cannot see, in **nine plugins**: MyBatis, Camel, SQS, Kafka, HTTP routes, Spring events, GraphQL, gRPC, Flyway.

TL;DR

provenlens pre-indexes a codebase into a graph of symbols and who-calls-what, stored in SQLite, so an AI agent can ask **one question** and get everything: the real source with line numbers, what calls this, what this calls, and what breaks if you change it — instead of a dozen rounds of grep and file reads.

It runs **100% offline**. No API calls, no telemetry, no network egress of any kind, and **nothing to compile** — `node:sqlite` ships inside Node 22.13+, and the grammars are WASM.

Quick start

**New here? [SETUP.md](SETUP.md) is the step-by-step guide** -- what to type, what you should see, what to do when you do not -- from a bare machine to Claude Code using the graph on its own. (*Tiếng Việt: [SETUP.vi.md](SETUP.vi.md).*) The five commands below are the short form of it.

git clone https://github.com/NamHT4Devlop/provenlens.git ~/provenlens && cd ~/provenlens && yarn install

ln -sf ~/provenlens/bin/provenlens.js ~/.local/bin/provenlens && provenlens --version

echo '.provenlens/' >> "$(git config --global core.excludesfile || echo ~/.config/git/ignore)"

cd /path/to/your/repo && provenlens init .

provenlens explore "SomeClassOrMethod"

The first indexes a repository once into `.provenlens/` at its root -- a cache, never committed, which the third line keeps out of every repository on the machine. The last is the one command worth remembering: source, callers, callees, bindings and blast radius in one answer. To have Claude Code use it on its own, one more:

provenlens install claude-user --hooks

That registers the MCP server and the two hooks ([step 9](#9-optional--wire-it-into-claude-