gitwtfhub

wtf is codelore?

paulbenchea/codelore — explained in plain English

Analysis updated 2026-05-18

11TypeScriptAudience · developerComplexity · 2/5Setup · easy

TL;DR

An MCP server that stores structured internal and usage documentation for a codebase so an AI assistant can fetch just what it needs.

Mindmap

mindmap
  root((CodeLore MCP))
    What it does
      Structured docs
      Internal and usage
      Auto generated index
      MCP tools
    Tech stack
      TypeScript
      Node.js
      MCP protocol
    Use cases
      AI assistant memory
      Codebase documentation
      Full text search
    Audience
      Developers
      AI agent users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Give an AI coding assistant a persistent, structured memory of how a codebase works

REASON 2

Store separate internal and usage documentation for each part of a project

REASON 3

Search across all project documentation with fuzzy keyword matching

REASON 4

Register the MCP server once and reuse it across every project in Claude Code

What's in the stack?

TypeScriptNode.jsMCP

How it stacks up

paulbenchea/codelore1476989162/vue-bill-print1e3pm/knowledge-chatbot
Stars111111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Works out of the box via npx once published to npm, no separate install step required.

Wtf does this do

CodeLore MCP is a server that gives an AI coding assistant a structured place to store and retrieve documentation about a codebase, so the assistant can read a short summary and fetch exactly the doc it needs instead of re-reading the whole codebase every time. Every piece of documentation comes in two versions: an internal doc that explains how the code works, and a usage doc that explains how to use it, with inputs, outputs, and examples. Documentation is organized in a folder hierarchy stored on disk, by default under a hidden folder in the user's home directory. Within a project, documentation is grouped by category, such as a technology like Angular or SQL, then by chapter, which is a functional area within that category, and finally by topic, which is the actual unit of documentation holding the internal and usage files. The server enforces this structure itself: names are automatically formatted consistently, each document gets standard metadata and a generated title, and the index files that list what exists are regenerated from disk on every write so they cannot fall out of sync. The AI assistant only ever needs to supply the actual written content. The server exposes a set of tools an assistant can call: listing and registering projects, defining categories, chapters, and topics, writing or reading a topic's internal or usage documentation, searching across all documentation with fuzzy and prefix matching, and getting a full map of a project's table of contents in one call. The intended flow is to build up documentation while working with a user, then later read back just the table of contents or a specific topic when doing a new task, or search by keyword when the right topic is not known in advance. Once published to npm, it can be registered with Claude Code using a single command, or added to any MCP client's configuration file with npx. Where documentation is stored can be customized with a root flag or an environment variable instead of using the default home directory location.

Yoink these prompts

Prompt 1
Walk me through registering codelore-mcp with Claude Code using claude mcp add
Prompt 2
Show me how to define a category, chapter, and topic in codelore
Prompt 3
Explain the difference between an internal doc and a usage doc in codelore
Prompt 4
How do I change where codelore stores its documentation using the root flag

Frequently asked questions

wtf is codelore?

An MCP server that stores structured internal and usage documentation for a codebase so an AI assistant can fetch just what it needs.

What language is codelore written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

How hard is codelore to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codelore for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.