klypix-mcp
Shared project memory for coding agents using one brain.klypix file committed with code.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Node.js 20 or newer
install klypix-mcp globally via npm
npm install -g klypix-mcp
Where the README and reality differ
- README: klypix-mcp --version / --help shows version/help
What worked: klypix-mcp without verb runs MCP server; --version/--help hang waiting for stdio, doctor command shows version v1.110.0
Check that it works
npx klypix-mcp doctor 2>&1 | tail -n 30
npx klypix-mcp runtime 2>&1 | tail -n 30
npx klypix-mcp conformance 2>&1The output should contain “KLYPIX MCP conformance v1.110.0: PASS”.
First thing to try
pwd; ls -la; cat ~/.local/bin/klypix-mcp | head -n 5; klypix-mcp init 2>&1; ls -lh *.klypix 2>&1; ls -lh brain* 2>&1npx klypix-mcp doctor 2>&1 | tail -n 30
npx klypix-mcp runtime 2>&1 | tail -n 30
npx klypix-mcp conformance 2>&1Add it to your agent
claude mcp add klypix-mcp -- klypix-mcp --vault '<vault>'JSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"klypix-mcp": {
"command": "klypix-mcp",
"args": [
"--vault",
"<vault>"
]
}
}
}Replace <vault> with your own path.
Run klypix-mcp init in your project folder to create the brain file, then add klypix-mcp --vault <project folder> to your MCP client as a server.
What it does
- Leave notes and handoffs between sessionsTested
How to use it
- Run
klypix-mcp initin your project folder. - Connect your MCP client to
klypix-mcp --vault <project folder>. - Call the brain_note tool with your note as "text" and an optional "area", such as {"text":"<your note>","area":"<area>"}.
- Run
- Carry project decisions over across sessionsNot shown working
- Get a warning when sessions touch the same filesNot shown working
- Guard shared git checkoutsNot shown working
How far pickfit got
Linux x86_64
- Installs
- Connects
- 1 of 4 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- carry project decisions over across sessions
- warn when two sessions touch same file
- leave notes and handoffs between sessions
- record corrections that supersede old decisions
- ask what the project believed at a past date
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 1.110.0
An MCP client handshake over stdio listed 29 tools, and a call to brain_sync returned a result.
Differences the test machine hit
- README: npx klypix-mcp install as install
In the test: npm install -g klypix-mcp used; install requires interactive project detection, global install provides launch command for offline replay