Lore

> The lore behind your projects. — getlore.ai · npm

Every project accumulates lore — the decisions, conversations, research, and context that explain why things are the way they are. Most of it gets lost between chat threads and forgotten docs. Lore keeps it searchable and citable.

A research knowledge repository with semantic search and citations. Unlike memory systems that store processed facts, Lore preserves your original sources and lets you cite exactly what was said, by whom, and when.

Quick Start

``bash
npm install -g @getlore/cli

Setup (API keys + login)

lore setup

Add a source directory (interactive prompts)

lore sync add

Sync and search

lore sync
lore search "user pain points"
`

What It Does

- Hybrid Search — Semantic + keyword search with Reciprocal Rank Fusion
- Citations — Every insight links back to the original source with context
- MCP Integration — 9 tools for Claude Desktop and Claude Code
- Agentic Research — Claude iteratively explores your knowledge, synthesizes findings with citations
- Multi-Machine Sync — Content hash deduplication across machines
- Universal Formats — Markdown, JSONL, JSON, PDF, images, CSV, HTML, and more

MCP Configuration

One-click install:


Run npx @getlore/cli setup first to configure API keys and sign in. The MCP server reads your config automatically — no env vars needed.

Manual config — add to your MCP client config (.mcp.json, .cursor/mcp.json, etc.):

`json
{
"mcpServers": {
"lore": {
"command": "npx",
"args": ["-y", "@getlore/cli", "mcp"]
}
}
}
`

CLI Commands

| Command | Description |
|---------|-------------|
| lore setup | Guided configuration wizard |
| lore auth login | Sign in with email OTP |
| lore sync | Sync all configured sources |
| lore sync add | Add a source directory |
| lore search | Hybrid search |
| lore research | AI-powered deep research |
| lore browse | Interactive TUI browser |
| lore docs list | List documents |
| lore projects | List projects |
| lore mcp | Start MCP server |

Requirements

- Node.js 18+
- OpenAI API key (embeddings)
- Anthropic API key (metadata extraction & research)
- Lore account (free — sign up via lore auth login)

How Sync Works

1. Discovery (free) — Finds files, computes SHA256 hashes, checks for duplicates
2. Processing (new files only) — Claude extracts metadata, OpenAI generates embeddings, stores in Supabase

Same content on different machines produces the same hash — no duplicate processing.

Agent Platform Install

Lore works with any agent that supports MCP. Use lore skills install or install directly from your platform's registry.

$3

`bash


From plugin directory (once approved)

/plugin install lore

Or install directly from GitHub

/plugin install https://github.com/getlore-ai/lore/tree/main/plugins/claude-code

Or via Lore CLI

lore skills install claude-code
`

$3

`bash


From Extensions Gallery

gemini extensions install lore

Or install directly from GitHub

gemini extensions install https://github.com/getlore-ai/lore --path plugins/gemini

Or via Lore CLI

lore skills install gemini
`

$3

`bash


Add MCP server

codex mcp add lore -- npx -y @getlore/cli mcp

Install skill

lore skills install codex
`

$3

`bash


From ClawHub

clawhub install lore

Or via Lore CLI

lore skills install openclaw
``

License

MIT