# live-memory

Keeps what your agent learned about the repo between sessions. It asks memory instead of reading the same files again.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: shofer-dev
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/shofer-dev/claude-code-live-memory
- Updated: 2026-08-01
- HTML: https://affpapa.org/en/nevibecode/mcp/live-memory

## What it does

live-memory runs as its own MCP server that builds up knowledge of your repository and outlives a single session. Your agent sends broad questions through one tool, `ask_live_memory` — where something lives, how a piece works, what calls it — and gets an answer it can act on right away. The server is read-only and confined to the workspace path: it cannot edit, create or execute anything.

Learning happens on its own. `PostToolUse` and `FileChanged` hooks take the file content your agent already reads or edits and hand it to the server, so nothing extra is scanned. Memory sits in a local JSON snapshot and tracks modifications and deletions. A single server covers every session in that workspace.

Start the server before Claude connects. The plugin only attaches to it and never launches it, so a stopped process means a connection error. On a Claude subscription it runs with no API key, and the memory model can be pointed at a local one or at any OpenAI-compatible endpoint.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add live-memory -- uvx shofer-live-memory
```
uvx runs the command named after the package; if the README names another one, use uvx --from shofer-live-memory <command>

### Codex

**Platform CLI**
```bash
codex mcp add live-memory -- uvx shofer-live-memory
```
uvx runs the command named after the package; if the README names another one, use uvx --from shofer-live-memory <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "live-memory": {
            "command": "uvx",
            "args": [
                "shofer-live-memory"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from shofer-live-memory <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "live-memory": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "shofer-live-memory"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from shofer-live-memory <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add live-memory uvx shofer-live-memory
```
uvx runs the command named after the package; if the README names another one, use uvx --from shofer-live-memory <command>

## When to use it
- locate a module somewhere in a large repo
- understand an unfamiliar part of the code
- trace which code calls a function
- carry codebase understanding across sessions
- cut the premium model's spend on re-reading files

## Example prompts
- Ask live-memory where the payment handler is defined
- What calls `buildIndex`, and from where?
- Show me what live-memory already knows about this repo

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