Turnbook
Your AI forgets everything when the session ends. This one remembers, and it never calls an LLM to do it.
88.8% on LongMemEval (measured on 0.9.9). Zero model tokens spent saving memory. Runs on your own PC.
Potencialize seu agente
O comando do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
uvx graph-mind-memory==0.9.43O Claude Code não tem link de instalação para um comando local. Copie o comando abaixo e execute-o em um terminal.
claude mcp add io.github.goyohan0611-png-graph-mind -- uvx graph-mind-memory==0.9.43Execute em um terminal.
{ "mcpServers": { "io.github.goyohan0611-png-graph-mind": { "command": "uvx", "args": [ "graph-mind-memory==0.9.43" ] } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
88.8% on LongMemEval (measured on 0.9.9). Zero model tokens spent saving memory. Runs on your own PC.
Local long-term memory shared by all your AI agents, kept word for word on your own PC.
Decide something with one agent on Monday. Ask another on Wednesday. It knows.
English · 한국어
Recorded live on one PC: Claude Code (Opus 5.5, effort high) and Codex (GPT-6.1-Sol, effort high) sharing one Turnbook memory. Model thinking time is fast-forwarded.
Windows: download Turnbook-Setup.cmd and double-click it, or in PowerShell:
irm https://raw.githubusercontent.com/goyohan0611-png/turnbook/main/scripts/install.ps1 | iex
macOS / Linux:
curl -LsSf https://raw.githubusercontent.com/goyohan0611-png/turnbook/main/scripts/install.sh | sh
No Python needed; nothing else to set up. Restart your AI apps afterwards. Already have Python?
pip install turnbook && turnbook-install. More: docs/install.md.
After pip install turnbook:
{
"mcpServers": {
"turnbook": {
"command": "python",
"args": ["-m", "graph_mind.mcp_server"]
}
}
}
Claude Code: claude mcp add turnbook -- python -m graph_mind.mcp_server. This gives the
tools only; turnbook-install also saves every conversation automatically.
Work as usual for a while, then open a new session, another app, or another model and ask:
Nothing to tag or save by hand: every turn is already stored, and the agent pulls back the few that answer the question.
turnbook folder share, then turnbook folder <code> on
the other PC (the AI tells you the command; it never moves your memory by itself, so a web page
cannot either). Office network or Tailscale, over TLS, every line
encrypted before it leaves a PC.turnbook export FILE writes all of it;
--project FOLDER writes only the conversations held in that folder. They run
turnbook import FILE.The installer finds these and connects them; run it again after installing a new one.
Any other MCP client works through the tools: see the hand-written config above.
flowchart LR
A["Claude Code · Codex · Cursor<br/>Gemini CLI · OpenCode · ..."] -- "transcripts, hooks, plugin" --> C["capture service<br/>(runs in the background)"]
C -- "verbatim turns,<br/>secrets masked" --> S[("your memory<br/>on this PC")]
S --> I["local search<br/>words + meaning + time"]
A -- "a question that needs the past" --> I
I -- "the few turns that answer it<br/>(~3k tokens)" --> A
Underneath, Turnbook is a retrieval engine for conversations: it stores every turn verbatim at no model cost and finds the few that answer a question by words, meaning and time (when it was said, what changed since), re-ranked by a small learned score. That is RAG over chat history, and the same engine could serve a chatbot that remembers each of its users, a support bot that recalls past tickets, or a team's searchable decision log. Today it ships as a personal, local memory; a Python API and multi-user server mode are not built yet. Interested? Open an issue.
LongMemEval is the public benchmark for long-term chat memory: 500 questions over about 50 past sessions each. Every system below got the same answer model (gpt-5-mini), the same prompt and the official gpt-4o judge; only the memory differs.
On agentmemory's 499 Turnbook scored 89.0%; on the 40, 85.0%. Retrieval alone, on agentmemory's own measure (an answer session among the first 5 retrieved): Turnbook 98.5%, agentmemory 95.2%. These runs used the embedding model of 0.9.9 and before; on a 100-question sample the current one finds the answer session as often or more (among the first 5: 99.0% against 97.9%).
Recall gets harder as memory piles up: more past conversations look like the one you mean. Since 0.9.46 Turnbook orders what it finds with a small learned score instead of a fixed blend. On LoCoMo (1,536 questions), with each person's memory grown to 10× by storing other conversations beside it, the share of questions whose answer reaches the model fell 5.6 points before (82.5% → 76.9%) and 3.1 points now (83.5% → 80.4%). Each conversation was scored with weights learned on the other nine; the added conversations are other people's, likely easier to tell apart than one person's own history. On LongMemEval the same change took the answer reaching the model from 97.5% to 98.3%.
0.9.47 adds more to that score (how rare the shared words are, how much of one past conversation was found) and looks at 100 candidates per search instead of 50. With LoCoMo inside a memory grown to 205,000 turns, the answer turn is among the first 30 found for 79.7% of questions, against 73.0% with the fixed blend of 0.9.45; a search takes about 0.4 s there.
Four LoCoMo conversations translated into Korean (582 questions). Share of questions whose answer turn is among the first 30 found:
Word search now finds "콩이" in "콩이를" (Korean particles), and the re-ranker was trained on two benchmarks instead of one. research/runs/graph-v9.21-korean
Every question, answer and verdict is in research/runs/; method, failures and
how to rerun it: docs/benchmarks.md.
Will it slow my PC down? The background service uses about 2% of one CPU core when nothing new is coming in and about 650 MB of memory, most of it the search model. A memory search takes about 20 ms (41 ms at the 95th percentile on a GitHub runner); the first one after an app starts, about 1.3 s. After an update that changes the search model, it reads the memory again once, at half pace (about an hour for 11,000 pieces).
What does it cost? Nothing. No API key and no model calls of its own; your AI app reads a packet of about 3k tokens when a question needs the past.
Does anything leave my PC? No, unless you share the memory with your own other PCs or a team. No telemetry. Secrets (API keys, passwords, card numbers...) are masked before storing.
How is this different from CLAUDE.md or an app's built-in memory? Those keep notes a model wrote, one app at a time. Turnbook keeps every turn as it was said and shares it across every app and model on the PC.
Korean? Yes: Korean and English conversations, and questions in either language. A Korean question about something said only in English is found most of the time, not always. Korean recall still trails English by about 7 points: In Korean.
How do I remove it? turnbook-uninstall disconnects every app and stops the service; the
memory stays in ~/.graph-mind unless you add --purge.
[!NOTE] Beta. Used daily on Windows. macOS and Linux pass every test in CI but have not seen daily use yet.
MCP tools · See your memory in 3D
(turnbook-view) · Changelog · Security ·
Development: pip install -r requirements.txt, then python -m unittest discover -s tests
Contributions are welcome. License: Apache-2.0.
Local long-term memory shared by all your AI agents, kept word for word on your own PC.
{ "mcpServers": { "io.github.goyohan0611-png-graph-mind": { "command": "uvx", "args": [ "graph-mind-memory==0.9.43" ] } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Graph MIND roda localmente via stdio.
Última verificação: 2026-11-09. Local long-term memory shared by all your AI agents, kept word for word on your own PC.