crewlore MCP server

Your coding agents keep relearning what your team already figured out.

crewlore reads the sessions your agents already produce, and your repo's pull requests, pulls out the decisions, procedures and gotchas, and writes them into a plain-text knowledge book inside your repo. Every entry quotes the exact line it came from, and records whether the team adopted it or tried it and declined. Runs on your machine with your own model key.

Sixty seconds on what it does and how it is used:

https://github.com/user-attachments/assets/b16cb272-da48-4756-89ba-1cc626629e0c

The same thing in a terminal. The recording below is the bundled demo, uv run python scripts/demo.py --step, which needs no API key: a handful of synthetic sessions compiled into a book, including one claim the team tried and declined.

pipx install crewlore

You need: Python 3.10 or newer; a model key (ANTHROPICAPIKEY or OPENAIAPIKEY) or a local OpenAI-compatible model; the GitHub CLI (gh auth login) if you want to compile pull requests; uv only for the no-key demo below.

Quickstart

Two ways in, depending on where your team's knowledge currently lives.

You already use Claude Code. Point lore at the transcripts it writes to disk. By default it reads only this repo's own transcripts, never the other projects on your machine.

cd my-repo
export ANTHROPIC_API_KEY=...     # or OPENAI_API_KEY, or a local model in .lore/config.yaml
lore init                        # create .lore/ in your repo
lore watch                       # read this repo's transcripts, scrub secrets, compile, prune — on an interval
lore query "billing webhook"     # ask the knowledge layer anything, anytime

You have a repo but no sessions yet. Compile its pull-request threads instead. Coding agents write much of their reasoning in PR descriptions and reviews — what they tried, why it failed, which constraint they hit — so a repo nobody has run an agent in locally already has a knowledge layer waiting:

cd my-repo
export ANTHROPIC_API_KEY=...
lore init
lore import-prs owner/repo       # closed PRs by default, agent-authored only; uses your gh login, stores no token
lore query "billing webhook"

Either way, commit .lore/ and your teammates inherit the book on their next git pull. Its own .gitignore keeps raw transcripts, raw PR exports, the extraction cache and usage counters out of git.

Trouble installing?

If pipx fails with Broken Python installation, platform.mac_ver() returned an empty value, your default Python is a broken install (sometimes seen with very recent Homebrew Python builds). This is about the interpreter pipx uses, not the package — pin a known-working one:

pipx install --python python3.13 crewlore

To make pipx default to Python 3.13 going forward: export PIPXDEFAULTPYTHON=$(which python3.13).

Try it without an API key

Shortened. The full README is on GitHub.