# Knowl

Local memory for AI agents. When a fact changes, the previous one stops being active instead of sitting next to the new one. Useful once CLAUDE.md gets long and wrong.

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

## What it does

Knowl keeps facts about your project and serves them to the agent over MCP or the CLI. It covers code, research and everyday notes. No API key, and the store stays on your machine.

The interesting part is supersession. Record that the project moved to Postgres and the earlier MySQL entry is no longer active, so the agent does not answer with both. When Knowl cannot tell whether a new fact replaces an old one, it keeps both and points you at the `knowl supersede` command. The author's measurements put retrieval at 98% with this behaviour and 47% without it.

Setup is `npm install -g @dat999zx/knowl`, then `knowl init` inside the project: it creates `.knowl/`, updates `.gitignore` and registers whichever agents it finds. Node.js 22 or newer is required. The package ships native modules, so the CLI itself will not run under Bun or Deno — Bun can install it, Node has to execute it.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.knowl.cloud/mcp/`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http knowl https://api.knowl.cloud/mcp/
```

2. **Platform CLI**
```bash
claude mcp add knowl -- npx -y @dat999zx/knowl
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add knowl --url https://api.knowl.cloud/mcp/
```

2. **Platform CLI**
```bash
codex mcp add knowl -- npx -y @dat999zx/knowl
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "knowl": {
            "url": "https://api.knowl.cloud/mcp/"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "knowl": {
            "command": "npx",
            "args": [
                "-y",
                "@dat999zx/knowl"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "knowl": {
            "type": "http",
            "url": "https://api.knowl.cloud/mcp/"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "knowl": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@dat999zx/knowl"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http knowl https://api.knowl.cloud/mcp/
```

2. **Platform CLI**
```bash
gemini mcp add knowl npx -y @dat999zx/knowl
```

## When to use it
- drop facts the agent still believes but that are no longer true
- share one project knowledge store across several agents
- keep a bloated `CLAUDE.md` out of the context window
- carry architecture decisions from one session to the next
- keep research notes next to the code they belong to

## Example prompts
- Which database does this project use? Check Knowl memory.
- Remember this: we moved to Postgres, the MySQL decision is retired.
- Look in Knowl for what we already settled about auth.

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