X
xy-claude/brain-core
A memory for your Claude Code agent that survives the session.
updated 2026-11-15
View on GitHub ↗Direct link · no redirect page
We have neither an install command nor a public remote endpoint from this repository, so we do not print a config. A made-up one is worse than none. How each client wires MCP up →
- Star count
- 0 ★ · xy-claude/brain-core · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 3 sources · mcp
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
xy-claude/brain-core;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# brain-core
Excerpted from the repository README (abridged)
A memory for your Claude Code agent that survives the session.
## Install in one line
macOS and Linux
bash
curl -fsSL https://raw.githubusercontent.com/xy-claude/brain-core/main/install.sh | bash -s -- --agent Atlas --user Alex --desktop
Windows (PowerShell)
powershell
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/xy-claude/brain-core/main/install.ps1))) -Agent Atlas -User Alex -Desktop
Atlas is your agent's name, Alex is yours. When the installer finishes:
bash
cd ~/Agents/Atlas
claude
Both lines install the same things: the agent, Hindsight (the vector store, about 2 GB), the daily and weekly jobs, Claude Code, and the connection to the Claude desktop app. No API key is needed.
| You want | macOS and Linux | Windows |
| The quick install: about a minute, no Hindsight | add --lite | add -Lite |
| Claude Code only, not the desktop app | remove --desktop | remove -Desktop |
Every step, every flag and the common problems: Install details.
## What you get
Sessions that start where the last one ended. Each one opens with yesterday's brief, your decisions, the facts that changed and the corrections you gave.
Five tools, not thirty. One local MCP server the agent uses by itself.
Files you can read. Memory is markdown in a folder on your disk, indexed by SQLite and, optionally, by Hindsight, a self-hosted vector memory.
Nothing in someone's cloud. Memory stays on your disk. What does go out: the LLM calls Hindsight makes to reason over memories (none with --lite), one version check a day to PyPI, and the pages you ask it to distill.
Search you can check. Every result names its file and date, a weak match is reported as weak, and recall is scored against labelled answers (the labels were written by a model and have not yet been checked by a person). The numbers, including the ones that are not flattering, are in Does it work?
It is for one person running one or more agents on their own computer. It is not a hosted service and not a team product.
## The problem
Every session with a coding agent starts from zero. You explain the project again, the decision you made last week again, the thing it got wrong on Tuesday again. Memory add-ons exist, but they put your notes in someone's cloud, expose 30 tools the agent cannot choose between, and nobody shows you an eval.
brain-core is the opposite: local, five tools, markdown files you own, and an eval with labelled answers whose numbers are published below.
## How it works
1. brain init scaffolds an agent folder. It writes a CLAUDE.md with the agent's name and yours, five rule files (identity, doctrine, authority, memory, system), three skills, four hooks (a safety block, the brief at session start, capture of what you said, recall of past fixes when a command fails), an .mcp.json and an empty vault. Claude Code reads that folder as a project, so the agent knows how to use its memory from the first message.
2. brain serve runs as an MCP server inside Claude Code. It exposes exactly five tools. The agent calls them the way it calls any other tool; you never run them by hand.
3. Every session has a shape. The agent opens with brain_session('start'), which returns one block: today's brief, the executive state, the mental models, a recall for each of the top two missions, the inbox count, and a flag if the previous session crashed. In Claude Code a hook has already put the brief in context (at most 3,000 tokens of it), so the block does not repeat it. It closes with brain_session('end'), which files the day's archive and rewrites state for tomorrow.
## Install in one line
macOS and Linux
bash
curl -fsSL https://raw.githubusercontent.com/xy-claude/brain-core/main/install.sh | bash -s -- --agent Atlas --user Alex --desktop
Windows (PowerShell)
powershell
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/xy-claude/brain-core/main/install.ps1))) -Agent Atlas -User Alex -Desktop
Atlas is your agent's name, Alex is yours. When the installer finishes:
bash
cd ~/Agents/Atlas
claude
Both lines install the same things: the agent, Hindsight (the vector store, about 2 GB), the daily and weekly jobs, Claude Code, and the connection to the Claude desktop app. No API key is needed.
| You want | macOS and Linux | Windows |
| The quick install: about a minute, no Hindsight | add --lite | add -Lite |
| Claude Code only, not the desktop app | remove --desktop | remove -Desktop |
Every step, every flag and the common problems: Install details.
## What you get
Sessions that start where the last one ended. Each one opens with yesterday's brief, your decisions, the facts that changed and the corrections you gave.
Five tools, not thirty. One local MCP server the agent uses by itself.
Files you can read. Memory is markdown in a folder on your disk, indexed by SQLite and, optionally, by Hindsight, a self-hosted vector memory.
Nothing in someone's cloud. Memory stays on your disk. What does go out: the LLM calls Hindsight makes to reason over memories (none with --lite), one version check a day to PyPI, and the pages you ask it to distill.
Search you can check. Every result names its file and date, a weak match is reported as weak, and recall is scored against labelled answers (the labels were written by a model and have not yet been checked by a person). The numbers, including the ones that are not flattering, are in Does it work?
It is for one person running one or more agents on their own computer. It is not a hosted service and not a team product.
## The problem
Every session with a coding agent starts from zero. You explain the project again, the decision you made last week again, the thing it got wrong on Tuesday again. Memory add-ons exist, but they put your notes in someone's cloud, expose 30 tools the agent cannot choose between, and nobody shows you an eval.
brain-core is the opposite: local, five tools, markdown files you own, and an eval with labelled answers whose numbers are published below.
## How it works
1. brain init scaffolds an agent folder. It writes a CLAUDE.md with the agent's name and yours, five rule files (identity, doctrine, authority, memory, system), three skills, four hooks (a safety block, the brief at session start, capture of what you said, recall of past fixes when a command fails), an .mcp.json and an empty vault. Claude Code reads that folder as a project, so the agent knows how to use its memory from the first message.
2. brain serve runs as an MCP server inside Claude Code. It exposes exactly five tools. The agent calls them the way it calls any other tool; you never run them by hand.
3. Every session has a shape. The agent opens with brain_session('start'), which returns one block: today's brief, the executive state, the mental models, a recall for each of the top two missions, the inbox count, and a flag if the previous session crashed. In Claude Code a hook has already put the brief in context (at most 3,000 tokens of it), so the block does not repeat it. It closes with brain_session('end'), which files the day's archive and rewrites state for tomorrow.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/xy-claude-brain-core/)
- Source
- awesome · https://github.com/xy-claude/brain-core
- Browse by field
- MCP servers
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.