使用说明
Mooncite
Mooncite lets coding agents recover past context without asking you to explain it again. It searches authorized Pi, OMP, Claude Code, Codex, and ChatGPT history stored on this machine. Before an agent relies on a result, mooncite_inspect checks the citation against the original file. That confirms where the text came from. It does not prove the text is still true.
Mooncite was formerly Claude Memory MCP. The repository keeps its old claude-memory-mcp URL.
flowchart LR
H[Human] -->|installs| M[Mooncite]
A[Coding agent<br/>Pi, OMP, Codex, Claude Code] -->|recall and inspect| M
M -->|reads only| S[Local history<br/>Pi, OMP, Claude Code, Codex, ChatGPT]
M <--> I[(Search index)]
M -->|cited context| A
Install
Mooncite requires Linux with procfs, Node.js 24 or newer, npm, and access to GitHub. Packaged local embeddings are Linux x64 only. Other Linux architectures still install and search lexically.
npx --yes github:WhenMoon-afk/claude-memory-mcp#v4.0.7 install
Tagged v4.0.7 is the current stable release. After installation, check the launcher. Then fully restart or reload each client whose registration is exact:
"$HOME/.local/bin/mooncite" status
The installer configures available Pi, OMP, Codex, and Claude Code clients. ChatGPT is a source, not a client. See operations for source setup, ChatGPT exports, removal commands, and quick fixes.
First search
Recall runs inside a configured client. It is not a shell command. Give the agent one distinctive phrase:
Call
mooncite_recallwith "". Start without a scope. If it returns a candidate, inspect that candidate'sevidence_idwithmooncite_inspect. Treatverifiedas proof that the cited text still matches its source file. It does not prove the text is true.
Mooncite exposes exactly three tools:
mooncite_recallsearches bounded local evidence. An unquoted query of at least two terms may add local embedding matches after no strong lexical hit.mooncite_inspectchecks a locator against current source bytes.mooncite_statusreports coverage and health without transcript text.
Read next
- Agent workflow tells an agent when to recall, narrow, inspect, and recover.
- MCP protocol lists exact tool inputs and outcomes.
- Operations covers install, source configuration, status, rebuild, disable, uninstall, and purge.
- Architecture explains the engine, index, and clients.
- Security explains source containment, local data handling, and deletion limits.
Mooncite never writes source history. Text returned through MCP becomes model context and is subject to that model provider's data handling.