Log inSubmit server
KLYPIX Project Brain logo

KLYPIX Project Brain

Shares versioned project memory, task presence, handoffs, overlap warnings, and coding rules across MCP-enabled agents.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install KLYPIX Project Brain

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "klypix-project-brain": {
      "command": "npx",
      "args": [
        "-y",
        "klypix-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

KLYPIX Project Brain MCP server gives coding agents a shared, Git-versioned project memory stored in a local `brain.klypix` file. Agents can synchronize decisions, leave notes, report task presence, pass handoffs, and receive warnings when sessions overlap on files. Claude Code receives deeper lifecycle integration, while other hosts use MCP tools and rules files to call functions such as `brain_sync` and `brain_note`. Reach for it when multiple coding sessions or agents need consistent project context without a hosted account.

Use cases

  • Share decisions across coding-agent sessions
  • Warn agents about overlapping file changes
  • Pass unfinished work to the next session
  • Record corrections and project-specific lessons
  • Protect shared-checkout Git operations in Claude Code

Key features

  • Versioned project memory in `brain.klypix`
  • Cross-session notes and handoffs
  • Task presence and file-overlap warnings
  • Host-specific lifecycle integration
  • Approved diff-based project rules
  • Shared-checkout Git guard for Claude Code

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

8/8 checks healthy over the last 43d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · klypix-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads4.4kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.

How KLYPIX Project Brain works

What KLYPIX Project Brain does

KLYPIX Project Brain keeps a project’s decisions, corrections, open questions, session activity, notes, and handoffs in one versioned brain.klypix file. The file is stored in the repository as a plain ZIP and can be committed with Git, so project context can travel with the code and remain available to later sessions.

The server is designed for coding agents working on the same project. It can report what a session intends to change, warn when sessions identify the same files, and preserve prior decisions as history when a correction supersedes them. Warnings are advisory: overlapping work is reported but not blocked.

How it works

KLYPIX runs locally and does not require the KLYPIX app or an account. Agents access the project brain through MCP. Claude Code can use lifecycle hooks for session-start context, prompt context, automatic turn-end capture, presence, and the shared-checkout Git guard. Codex receives native MCP tools, presence, and brain_sync, with optional hooks. Other supported hosts rely on the agent calling tools such as brain_sync and brain_note.

The server can carry notes between sessions, including sessions that have already closed. If a session ends before completing its work, the next local session can receive its activity and a handoff card can preserve next steps through Git. With KLYPIX network installed on both computers, sessions in the same project can also be listed across teammates’ computers.

Setup and configuration

Use Node.js 20 or newer, then run the installer from the project directory:

Terminal
npx klypix-mcp install

The installer creates brain.klypix when needed, configures editors it finds on the machine, and checks that the MCP tools respond. Reopen or reconnect the coding host, approve the tools if prompted, and verify the installation with:

Terminal
npx klypix-mcp doctor

Codex can receive optional hooks through --codex-hooks. Hosts configured through linking include Windsurf and Aider; Claude Desktop can be configured through the KLYPIX app’s settings or manually. The server runs on the developer’s machine, and its brain data remains in project files.

Tools and capabilities

The installation provides 27 MCP tools on Linux and macOS, and 28 on Windows because Windows adds show_in_klypix. Capabilities include:

  • Synchronizing project decisions and context with brain_sync.
  • Leaving cross-session notes with brain_note.
  • Recording task intent and session presence.
  • Warning about file overlap between active sessions.
  • Preserving handoffs and unfinished-work context.
  • Turning approved lessons into project rules that inspect diffs and can warn during planning, editing, or commits.
  • Protecting shared-checkout Git work in Claude Code by stopping certain unsafe commits and saving rescue copies before destructive commands.

Project rules can be configured as blocking only with human approval. An optional Git hook can enforce rules at commit time for agents or people.

Limitations and notes

Integration depth depends on the host. Claude Code supports the most automation; Codex has native tools but no automatic capture; and several editors depend on the agent invoking KLYPIX tools. KLYPIX does not launch, supervise, replace, or route agents, and it is not a worktree manager or Git replacement.

Overlap warnings do not prevent edits. Rules inspect diffs but do not run tests. The local server stores brain data in project files, while information read by an agent may still be sent to that agent’s model provider. Cross-computer session visibility requires KLYPIX network on both computers.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about KLYPIX Project Brain

KLYPIX Project Brain is an MCP server that connects coding agents to a versioned `brain.klypix` project file. Its main tools include `brain_sync` for shared decisions and context and `brain_note` for cross-session messages, with additional presence, handoff, overlap-warning, and project-rule capabilities.

Run `npx klypix-mcp install` inside the project with Node.js 20 or newer. The installer creates or reuses `brain.klypix`, configures detected editors, and checks the tools. Reconnect the host afterward, then run `npx klypix-mcp doctor` to verify it.

Yes, KLYPIX Project Brain supports Cursor through MCP configuration and an always-on rules file. The agent calls `brain_sync` and `brain_note` itself, and installation can configure Cursor when it is detected on the machine.

Yes, it warns when active sessions name the same file, but it does not block the edit. Each session reports its intended work and expected files, allowing agents to receive overlap information while continuing independently.

No, the local server works without the KLYPIX app or an account. Its brain data stays in the project’s files, although content that an agent reads can still be sent to that agent’s model provider.

Related MCP servers

All in Coding Agents All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewKLYPIX Project Brain AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/klypix-project-brain?style=directory)](https://allmcps.com/mcp/klypix-project-brain)
HTML Embed
<a href="https://allmcps.com/mcp/klypix-project-brain"><img src="https://allmcps.com/api/badge/klypix-project-brain?style=directory" alt="KLYPIX Project Brain on AllMCPs" /></a>