# lore

Pools session transcripts from several coding agents into a single local database any MCP client can search. Useful when the window compacted and you need that earlier debugging thread back.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Author: jordanhindo
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jordanhindo/lore
- Updated: 2026-06-26
- HTML: https://affpapa.org/en/nevibecode/mcp/lore

## What it does

Lore writes everything to `~/.lore/lore.db` on your own machine. Every connected agent reads the same store, so a session you ran in Claude shows up from Cursor too. The index keeps identifiers such as `getUserById` and file names searchable as whole tokens instead of splitting them apart.

Filling the store is a single command: `lore setup` detects the harnesses on the box and indexes each one. You can also point it at a directory yourself, for instance `lore index ~/.claude/projects` for Claude or `lore index ~/.codex/sessions --source codex`. Cursor and openclaw are picked up through `--source`. The npm package ships the `lore` skill plus `lore-recall`, `lore-brief`, `lore-handoff` and `lore-dev-verification`.

Node 22 or newer is required. When `npm install` trips over `better-sqlite3`, the build from source is the other route. A global CLI goes stale quietly, and `lore status --json` exposes the mismatch by reporting a `schemaVersion` above `supportedSchemaVersion`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add lore -- npx -y @jordanhindo/lore
```

### Codex

**Platform CLI**
```bash
codex mcp add lore -- npx -y @jordanhindo/lore
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lore": {
            "command": "npx",
            "args": [
                "-y",
                "@jordanhindo/lore"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "lore": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@jordanhindo/lore"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add lore npx -y @jordanhindo/lore
```

## When to use it
- recover what one agent learned from another agent's session
- pick up a debugging thread lost to context compaction
- index Claude and Codex transcripts into the same store
- search code identifiers and file names without losing them to tokenisation
- hand off work between sessions as a brief or handoff note

## Example prompts
- Set up lore and prove search works against my past sessions
- Look in lore for how we fixed the error in `auth.ts` last time
- Index `~/.claude/projects` including the subagent transcripts

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md