# LoreConvo

Local session memory for Claude and other agents, kept in SQLite with full-text search. Project context survives a restart.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: labyrinth-analytics
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/labyrinth-analytics/loreconvo
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/loreconvo

## What it does

LoreConvo keeps your session history in `~/.loreconvo/sessions.db` on your own machine. Two kinds of memory get written: what happened during a session (summaries, artifacts, questions left open) and which project decisions still stand. Search runs on FTS5, and queries containing identifiers such as `autoSave` or `get_context_for` are split into compound tokens first.

Inside Claude the server leans on hooks. `auto_save.py` writes a structured summary when a session ends; `auto_load.py` runs at the start of the next one, ranks recent sessions by how much signal they carry, and feeds the useful context back in. Sessions with open questions and decisions rank highest. A `MEMORY.md` in the project directory gets indexed too.

Cursor connects through `.cursor/mcp.json`, Codex through `~/.codex/config.toml`, Gemini CLI through `gemini mcp add`. Automatic capture only happens if you install the session hooks yourself — otherwise you save memories by hand with the save tools. Nothing leaves your disk unless you turn on the optional summarization feature, which sends an excerpt to the Anthropic API with your own key and is off by default.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `LORECONVO_PRO` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add loreconvo -e LORECONVO_PRO=<LORECONVO_PRO> -- uvx loreconvo
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from loreconvo <command>

### Codex

**Platform CLI**
```bash
codex mcp add loreconvo --env LORECONVO_PRO=<LORECONVO_PRO> -- uvx loreconvo
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from loreconvo <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "loreconvo": {
            "command": "uvx",
            "args": [
                "loreconvo"
            ],
            "env": {
                "LORECONVO_PRO": "<LORECONVO_PRO>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from loreconvo <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "loreconvo": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "loreconvo"
            ],
            "env": {
                "LORECONVO_PRO": "<LORECONVO_PRO>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from loreconvo <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e LORECONVO_PRO=<LORECONVO_PRO> loreconvo uvx loreconvo
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from loreconvo <command>

## When to use it
- pick up a project's context after restarting Claude
- track down which session covered a given module
- keep decisions from getting lost between sessions
- carry context from Claude over to Cursor or Codex
- copy the latest session to the clipboard for Claude Chat

## Example prompts
- Save this session to project memory
- Remind me what we decided about the database schema
- Search past sessions for `pipeline_tracker`

## 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