For developers & platform teams
Typed, line-anchored facts for every file — stored as a git mirror your agents can read.
BNLGit sits beside your repo and generates a summary twin for every source file: auth.py →
auth.py.llm, carrying structured facts — symbols, imports, endpoints, DB entities, side
effects — each anchored to a line and pinned to a blob SHA. It's a real git mirror: diffable,
reviewable in PRs, greppable, offline, and consumable by any tool that speaks MCP.
The mechanic
A summary mirror, versioned right next to the source.
src/auth.py
Your source. Untouched. The source of truth.
src/auth.py.llm
Typed facts · line-anchored · pinned to this blob SHA.
src/auth.py.llmverified_current
# generated fact block — schema v3
symbol verify_token(token: str) -> Claims @ L42
reads env "JWT_PUBLIC_KEY"
raises ExpiredSignatureError, InvalidToken
security signature checked before payload is trusted @ L51
endpoint POST /api/session -> verify_token @ L88
db none
stale? no # tracks blob 9f3c1e… ; re-derives on change
Agents retrieve the facts over MCP, then jump straight back to the exact source line at the pinned
commit — no re-reading whole files, no stale context, no hallucinated behaviour. When a source blob
changes, its twin is marked stale and re-derived; coverage is honest to the SHA.