booklib

# BookLib

Context engineering tool for AI coding assistants. Detects post-training knowledge gaps in your dependencies, resolves them automatically, and delivers context via MCP to 14 AI tools.

## What It Does

- Scans dependencies across 10 package ecosystems (npm, PyPI, Maven, Cargo, etc.)
- Cross-references with source code to find exact files and APIs affected
- Auto-resolves gaps via Context7, GitHub releases, web docs
- Injects context at runtime via PreToolUse/PostToolUse hooks
- Captures team decisions and enforces them via `guard` tool
- 23 expert skills distilled from canonical books (Clean Code, DDD, Effective Java, etc.)

## MCP Tools (5)

- lookup — search for post-training docs, team decisions, expert knowledge
- review — deep code review against a named skill
- remember — capture a team decision or insight
- verify — check if imports are covered by the index
- guard — check if code contradicts team decisions

## CLI

- booklib init — guided setup (detects stack, registers MCP, builds index)
- booklib gaps — detect post-training dependencies
- booklib fix — auto-resolve gaps via Context7/GitHub
- booklib analyze — show affected files and APIs
- booklib search — hybrid search (BM25 + vector + reranker)

## Install

npm install -g @booklib/core
booklib init

## Links

- Website: https://booklib-ai.github.io/booklib/
- GitHub: https://github.com/booklib-ai/booklib
- npm: https://www.npmjs.com/package/@booklib/core