# KLYPIX Shared Project Memory

An MCP server keeps project decisions, corrections, and handoffs in brain.klypix so separate coding sessions can use the same context.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: dahshanlabs
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dahshanlabs/klypix-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/klypix-shared-project-memory

## What it does

KLYPIX stores project decisions, corrections, and open questions in a `brain.klypix` file committed with the code. People can edit that file directly. The server also flags overlapping work when separate sessions expect to touch the same file, while leaving edits unblocked.

Sessions can pass notes and unfinished work to whoever continues later. In Claude Code, KLYPIX adds lifecycle hooks and a Git guard for a shared checkout. A destructive command gets a rescue copy before confirmation; other hosts use calls such as `brain_sync` and `brain_note` when the agent makes them.

Node.js 20 or newer is required. Without it, `npx klypix-mcp install` cannot run, so check that dependency before connecting the server.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KLYPIX_VAULT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env KLYPIX_VAULT=<KLYPIX_VAULT> --transport stdio klypix-shared-project-memory -- npx -y klypix-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add klypix-shared-project-memory --env KLYPIX_VAULT=<KLYPIX_VAULT> -- npx -y klypix-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "klypix-shared-project-memory": {
            "command": "npx",
            "args": [
                "-y",
                "klypix-mcp"
            ],
            "env": {
                "KLYPIX_VAULT": "<KLYPIX_VAULT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "klypix-shared-project-memory": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "klypix-mcp"
            ],
            "env": {
                "KLYPIX_VAULT": "<KLYPIX_VAULT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KLYPIX_VAULT=<KLYPIX_VAULT> klypix-shared-project-memory npx -y klypix-mcp
```
Replace <…> with your own values

## When to use it
- carry decisions across coding sessions
- warn about two sessions editing one file
- hand notes to a later session
- protect a shared checkout from discarded work
- turn approved lessons into project rules

## Example prompts
- Sync this session with the project memory using `brain_sync`, then follow its recorded decisions.
- Add a project note with `brain_note`: the public API of this module must stay unchanged.
- Check whether another session plans to edit these files before you start.

## Similar
- [memory-management](https://affpapa.org/en/nevibecode/skills/memory-management-2.md) — skill · 1100 installs
- [Montycat MCP - Shared Memory for AI Agents](https://affpapa.org/en/nevibecode/mcp/montycat-mcp-shared-memory-for-ai-agents.md) — MCP server · ★ 23
- [SPM - Structured Project Memory](https://affpapa.org/en/nevibecode/mcp/spm-structured-project-memory.md) — MCP server
- [Listspace](https://affpapa.org/en/nevibecode/mcp/listspace.md) — MCP server
- [project-session-manager](https://affpapa.org/en/nevibecode/skills/project-session-manager.md) — skill · 872 installs
- [spark-recipe-shared-inbox-status](https://affpapa.org/en/nevibecode/skills/spark-recipe-shared-inbox-status.md) — skill · 336 installs

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