# Komplyt Zero

A shared memory graph for coding agents across multiple editors. It retains technical decisions and reasoning so projects keep context across restarts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17
- Author: Komplyzen
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Komplyzen/komplyt-zero/tree/HEAD/src
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/komplyt-zero

## What it does

AI assistants forget technical decisions once a session ends. Komplyt Zero bridges this gap by offering a single memory graph that works across Claude Code, Cursor, and other tools. Instead of relying on raw keyword matching, it records decisions, issues, and reasoning as typed nodes. You query them by meaning later.

Search results combine semantic similarity with a decay mechanism. Knowledge that sees regular use remains near the top, while untouched notes drop in priority. Nothing gets erased. A single match also retrieves connected items along graph edges.

Running the Docker quickstart requires Docker Compose, SurrealDB, and an Ollama instance. Because the local setup runs without token checks, do not route traffic to it outside localhost without an authenticating proxy.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://kg.kompl.yt/mcp`
- Environment variables: `KG_AUTH_MODE`, `KG_DB_URL`, `KG_DB_USER`, `KG_DB_PASS`, `KG_JWT_SECRET`, `EMBEDDING_PROVIDER`, `EMBEDDING_BASE_URL`, `EMBEDDING_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http komplyt-zero https://kg.kompl.yt/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env KG_AUTH_MODE=<KG_AUTH_MODE> --env KG_DB_URL=<KG_DB_URL> --env KG_DB_USER=<KG_DB_USER> --env KG_DB_PASS=<KG_DB_PASS> --env KG_JWT_SECRET=<KG_JWT_SECRET> --transport stdio src -- npx -y @komplyzen/komplyt-zero
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add src --url https://kg.kompl.yt/mcp
```

2. **Platform CLI**
```bash
codex mcp add src --env KG_AUTH_MODE=<KG_AUTH_MODE> --env KG_DB_URL=<KG_DB_URL> --env KG_DB_USER=<KG_DB_USER> --env KG_DB_PASS=<KG_DB_PASS> --env KG_JWT_SECRET=<KG_JWT_SECRET> -- npx -y @komplyzen/komplyt-zero
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "src": {
            "url": "https://kg.kompl.yt/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "src": {
            "command": "npx",
            "args": [
                "-y",
                "@komplyzen/komplyt-zero"
            ],
            "env": {
                "KG_AUTH_MODE": "<KG_AUTH_MODE>",
                "KG_DB_URL": "<KG_DB_URL>",
                "KG_DB_USER": "<KG_DB_USER>",
                "KG_DB_PASS": "<KG_DB_PASS>",
                "KG_JWT_SECRET": "<KG_JWT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "src": {
            "type": "http",
            "url": "https://kg.kompl.yt/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "src": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@komplyzen/komplyt-zero"
            ],
            "env": {
                "KG_AUTH_MODE": "<KG_AUTH_MODE>",
                "KG_DB_URL": "<KG_DB_URL>",
                "KG_DB_USER": "<KG_DB_USER>",
                "KG_DB_PASS": "<KG_DB_PASS>",
                "KG_JWT_SECRET": "<KG_JWT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http src https://kg.kompl.yt/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e KG_AUTH_MODE=<KG_AUTH_MODE> -e KG_DB_URL=<KG_DB_URL> -e KG_DB_USER=<KG_DB_USER> -e KG_DB_PASS=<KG_DB_PASS> -e KG_JWT_SECRET=<KG_JWT_SECRET> src npx -y @komplyzen/komplyt-zero
```
Replace <…> with your own values. 3 more environment variables are in the server README

## When to use it
- retain architectural rationale between different agent sessions
- share project decisions across distinct editor clients
- query past technical choices by semantic meaning
- stop teams from rehashing previously settled debates

## Example prompts
- Store our decision to use Postgres for background jobs in the acme-api project with the rationale.
- Search the knowledge graph to see why we avoided Redis for queue processing.
- Start a new session in the acme-api memory graph before making changes.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

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